Shardeum MCP Server

Shardeum MCP 服务

用于在 Shardeum 上检查分布式系统并支持开发工作流的 Model Context Protocol 服务。

此项目将 Shardeum 网络和 RPC 操作封装为结构化 MCP 工具，让 AI Agent、IDE 助手和开发工作流能够通过经过验证的工具调用检查分布式系统状态，而不必编写临时脚本。该项目面向由 Agent 驱动的调试、节点／网络检查和可重复的开发操作。

展示内容

• 用于 AI Agent 工具调用的 MCP 服务实现
• 基于分布式系统 RPC 方法的结构化工具调用接口
• 节点、周期、账户、区块、交易和收据检查
• 与 Cursor 和兼容 MCP 的客户端集成
• 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 服务为 Agent 提供对外部系统的操作访问权限。此项目将分布式系统 RPC 调用转换为明确的工具架构，相较于自由形式的 Shell 或 HTTP 访问，这让 Agent 操作更易于验证、调试和限制。

路线图

• 扩展支持的网络方法
• 添加具有明确确认关卡的安全写入交易工作流
• 改进类型化响应和验证
• 添加更全面的分布式系统诊断
• 为兼容 MCP 的客户端添加更多部署示例