Add Sei MCP Server as new package by codebycarson · Pull Request #249 · sei-protocol/sei-js

codebycarson · 2025-05-23T23:36:28Z

Sei MCP Server

This PR adds a new package called @sei-js/mcp-server for use with LLM's. It is a fork of a more generalized EVM MCP and will be improved moving forwards. See the README for local development. This package uses the same build tools and release workflows as every other @sei-js package.

This MCP server contains a variety of prompts and tools included and works in stdio or http mode.

Adding to Claude

Claude > Settings > Developer > Edit Settings

{
  "mcpServers": {
    "sei": {
      "command": "npx",
      "args": [
        "-y",
        "@sei-js/mcp-server"
      ],
      "env": {
        "PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Add Sei MCP Server Package

changeset-bot · 2025-05-23T23:36:31Z

🦋 Changeset detected

Latest commit: 467bb3b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@sei-js/mcp-server	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Copilot

Pull Request Overview

Adds a new @sei-js/mcp-server package to provide an MCP server for Sei/EVM networks, including a stdio entrypoint, core blockchain service utilities, and a suite of LLM prompts.

Introduces src/index.ts to launch the server over stdio
Implements core services (clients, transactions, tokens, contracts, blocks, balance, utils)
Registers a variety of EVM-related prompts and configures environment/chain mappings

Reviewed Changes

Copilot reviewed 39 out of 39 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
packages/mcp-server/src/index.ts	Server startup entrypoint using `StdioServerTransport`
packages/mcp-server/src/core/services/utils.ts	Utility functions for parsing, formatting, and address validation
packages/mcp-server/src/core/services/clients.ts	Public and wallet client creation with caching
packages/mcp-server/src/core/services/transactions.ts	Transaction retrieval and gas estimation
packages/mcp-server/src/core/services/tokens.ts	ERC20, ERC721, ERC1155 token data readers
packages/mcp-server/src/core/services/contracts.ts	Contract read/write, logs, and contract detection
packages/mcp-server/src/core/services/blocks.ts	Block retrieval utilities
packages/mcp-server/src/core/services/balance.ts	Balance queries and NFT ownership checks
packages/mcp-server/src/core/services/index.ts	Aggregates and re-exports all services and common types
packages/mcp-server/src/core/prompts.ts	Registration of EVM-related LLM prompts
packages/mcp-server/src/core/config.ts	Environment variable loading and key formatting
packages/mcp-server/src/core/chains.ts	Chain ID and RPC URL resolution mappings
packages/mcp-server/package.json	Package metadata, dependencies, scripts, and publish config
packages/mcp-server/jest.config.js	Jest setup
packages/mcp-server/LICENSE	MIT License
packages/mcp-server/.npmignore	Files to exclude from npm package
packages/mcp-server/.gitignore	Files to ignore in git
packages/mcp-server/.env.example	Example environment variables
.changeset/thirty-results-thank.md	Initial release changeset

Comments suppressed due to low confidence (4)

packages/mcp-server/src/index.ts:10

The startup message refers to "EVM MCP Server" but this package is called sei-js/mcp-server. Consider updating the log to "Sei MCP Server running on stdio" for consistency.

console.error("EVM MCP Server running on stdio");

packages/mcp-server/src/core/services/balance.ts:182

The as Promise<bigint> assertion is incorrect: the await unwraps the promise, so you should assert the result as bigint (or remove the assertion entirely).

return await readContract({ address: validatedTokenAddress, abi: erc721Abi, functionName: 'balanceOf', args: [validatedOwnerAddress] }, network) as Promise<bigint>;

packages/mcp-server/src/core/services/utils.ts:14

The formatJson and validateAddress utilities are untested. Consider adding unit tests to cover big-int JSON formatting and address validation logic.

formatJson: (obj: unknown): string => JSON.stringify(obj, (_, value) =>

packages/mcp-server/package.json:6

The bin field points to ./bin/cli.js, but no such file exists in the package. Add the CLI script or remove/update the bin entry to prevent publish errors.

"bin": "./bin/cli.js",

dssei

lgtm, We need to update the readme with correct repo and mcp configs

dssei · 2025-05-24T00:07:37Z

+
+## 🛠️ Prerequisites
+
+- [Bun](https://bun.sh/) 1.0.0 or higher


We probably do not need that anymore?

Updated this

dssei · 2025-05-24T00:07:55Z

+
+```bash
+# Clone the repository
+git clone https://github.com/sei-protocol/sei-mcp-server.git


moved to sei-js

Updated this

dssei · 2025-05-24T00:08:14Z

+      "command": "npx",
+      "args": [
+        "-y",
+        "@sei-protocol/sei-mcp-server"


needs update

dssei · 2025-05-24T00:11:43Z

+/**
+ * Read from a contract for a specific network
+ */
+export async function readContract(params: ReadContractParameters, network = 'sei') {


this change seems to lack the latest changes https://github.com/sei-protocol/sei-mcp-server/blob/main/src/core/services/contracts.ts#L16

Pulled them all in now and updated the tests

codecov-commenter · 2025-05-24T00:35:29Z

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 7.18%. Comparing base (aeeee09) to head (467bb3b).
Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff            @@
##            main    #249      +/-   ##
========================================
+ Coverage   6.18%   7.18%   +0.99%     
========================================
  Files        271     284      +13     
  Lines      48957   49484     +527     
  Branches   17117   17235     +118     
========================================
+ Hits        3030    3557     +527     
  Misses     45927   45927

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Copilot

Pull Request Overview

This PR introduces a new package, @sei-js/mcp-server, which provides an MCP server designed for interacting with EVM-compatible networks via both stdio and HTTP modes. Key changes include the initialization of a Stdio server transport, the implementation of various blockchain service functions (such as transaction, balance, token, contract, and block handling), and the registration of multiple prompts using zod validation.

Reviewed Changes

Copilot reviewed 40 out of 40 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
packages/mcp-server/src/index.ts	Initializes the MCP server and connects it to a Stdio transport.
packages/mcp-server/src/core/services/*.ts	Implements various blockchain service functions and helper utils.
packages/mcp-server/src/core/prompts.ts	Registers multiple EVM-related prompts using zod for input schema.
packages/mcp-server/src/core/config.ts, chains.ts	Sets up environment variables, network mappings, and RPC URLs.
Other files (package.json, jest.config.js, etc.)	Provide package metadata, build configuration, and supporting files.

Copilot · 2025-05-24T01:20:49Z

+ * @returns Transaction hash
+ * @throws Error if no private key is available
+ */
+export async function writeContract(params: Record<string, any>, network = DEFAULT_NETWORK): Promise<Hash> {


Consider defining a specific type for the 'params' parameter in writeContract instead of using Record<string, any> to enhance type safety and clarity.

Suggested change

export async function writeContract(params: Record<string, any>, network = DEFAULT_NETWORK): Promise<Hash> {

export async function writeContract(params: WriteContractParameters, network = DEFAULT_NETWORK): Promise<Hash> {

- Fixed formatting issues according to Biome - Fixed Typescript warnings line non-null assertions

- Added test cases for everything

- Fixed windsurf MCP issues - Removed CT changeset as it is delayed

…p-server

…nto feature/mcp-server

codebycarson added 6 commits May 23, 2025 16:00

Add Sei MCP Server

1e9658e

Add Sei MCP Server Package

Update install state and package version

f0fe75d

Added changeset

54a917e

No console log in stdio app

92f1a07

Reset Changelog and package version

014ad30

Added changeset

a001235

codebycarson requested a review from Copilot May 23, 2025 23:38

Copilot AI reviewed May 23, 2025

View reviewed changes

dssei approved these changes May 24, 2025

View reviewed changes

dssei reviewed May 24, 2025

View reviewed changes

codebycarson added 2 commits May 23, 2025 17:28

Updated Tests to use Jest

0c314d6

Fixed typedoc name and cleaned up tsconfig

ed856e9

codebycarson added 3 commits May 23, 2025 17:39

Pulled in latest changes & reformatted every file

730c9d1

Updated README.md

61f2b26

Removed console log

599777d

codebycarson requested a review from Copilot May 24, 2025 01:20

Copilot AI reviewed May 24, 2025

View reviewed changes

codebycarson and others added 8 commits May 23, 2025 18:33

Fixed typescript and biome formatting issues

aadf2c6

Biome and Typescript fixes

4c5d55f

- Fixed formatting issues according to Biome - Fixed Typescript warnings line non-null assertions

Added test cases (#250)

7a6e741

- Added test cases for everything

Fixed Windsurf issues

cce46b9

- Fixed windsurf MCP issues - Removed CT changeset as it is delayed

Merge branch 'main' of github.com:sei-protocol/sei-js into feature/mc…

02bde38

…p-server

Added back http scripts and updated README

7ef4e88

Merge branch 'feature/mcp-server' of github.com:sei-protocol/sei-js i…

373e2d0

…nto feature/mcp-server

Fixed package.json

467bb3b

codebycarson merged commit 4e2719c into main May 29, 2025
3 checks passed


		## 🛠️ Prerequisites

		- [Bun](https://bun.sh/) 1.0.0 or higher

	export async function writeContract(params: Record<string, any>, network = DEFAULT_NETWORK): Promise<Hash> {
	export async function writeContract(params: WriteContractParameters, network = DEFAULT_NETWORK): Promise<Hash> {

Conversation

codebycarson commented May 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Sei MCP Server

Adding to Claude

Uh oh!

changeset-bot Bot commented May 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

dssei left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

codecov-commenter commented May 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Copilot AI May 24, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

codebycarson commented May 23, 2025 •

edited

Loading

changeset-bot Bot commented May 23, 2025 •

edited

Loading

codecov-commenter commented May 24, 2025 •

edited

Loading