Shardeum MCP Server

Shardeum MCP Server

Shardeum の分散システムの調査と開発ワークフローのための Model Context Protocol サーバーです。

このプロジェクトでは、Shardeum のネットワーク操作と RPC 操作を構造化された MCP ツールとして公開します。これにより、AI エージェント、IDE アシスタント、開発ワークフローは、場当たり的なスクリプトを使う代わりに、検証済みのツール呼び出しを通じて分散システムの状態を調査できます。エージェント主導のデバッグ、ノード／ネットワークの調査、再現可能な開発作業向けに設計されています。

実証する内容

• AI エージェントによるツール利用向けの MCP サーバー実装
• 分散システムの RPC メソッドを利用する、構造化されたツール呼び出しインターフェース
• ノード、サイクル、アカウント、ブロック、トランザクション、レシートの調査
• Cursor および MCP 互換クライアントとの IDE 統合
• Docker によるデプロイ方法
• ネットワークおよび RPC の障害に対するエラー処理
• MseeP／Smithery バッジによる、セキュリティレビュー済み MCP サーバーの掲載

アーキテクチャ

MCP client / AI agent / Cursor
        |
        v
Shardeum MCP Server
        |
        +-- tool schema
        +-- request validation
        +-- RPC adapter
        +-- error handling
        |
        v
Shardeum RPC endpoint
        |
        v
Structured response to agent

対応するツールの分野

ネットワークとノードの調査

• shardeum_getNodeList
• shardeum_getNetworkAccount
• shardeum_getCycleInfo

ブロックとトランザクションの調査

• eth_blockNumber
• eth_getBlockByHash
• eth_getBlockByNumber
• eth_getBlockReceipts
• eth_getTransactionByHash
• eth_getTransactionReceipt
• eth_getTransactionCount

アカウントと実行に関するクエリ

• eth_getBalance
• eth_estimateGas
• eth_chainId

Cursor との統合

リポジトリをクローンし、依存関係をインストールして、MCP サーバーを登録します。

npm install

Cursor の MCP 設定：

{
  "mcpServers": {
    "shardeum-mcp": {
      "command": "node",
      "args": ["path_to/shardeum-mcp-server/index.js"]
    }
  }
}

プロンプトの例：

What is the current Shardeum block number?
List available network nodes and summarize their state.
Fetch the receipt for this transaction and explain the result.
Inspect this account balance and transaction count.

設定

サーバーの設定で RPC エンドポイントを指定するか、対象環境に合わせて rpcUrl 定数を更新してください。

Docker

docker build -t shardeum-mcp-server .
docker run --rm shardeum-mcp-server

これが単純ではない理由

MCP サーバーにより、エージェントは外部システムを操作できるようになります。このプロジェクトでは、分散システムへの RPC 呼び出しを明示的なツールスキーマに変換します。これにより、自由形式のシェルや HTTP によるアクセスと比べて、エージェントの操作を検証、デバッグ、制限しやすくなります。

ロードマップ

• 対応するネットワークメソッドを拡充
• 明示的な確認ゲートを設けた、安全に書き込みを行うトランザクションワークフローを追加
• 型付きレスポンスと検証を改善
• 分散システムの診断機能を拡充
• MCP 互換クライアント向けのデプロイ例を追加