Ethereum RPC MPC 服务器

一个 TypeScript MCP 服务器，利用 MCP SDK 支持所有 Ethereum JSON-RPC 调用，使 AI 模型能够与区块链数据交互。

概述

本项目提供了一个模型上下文协议 (MCP) 服务器，允许像 Cursor 或 Claude 这样的 AI 助手（或任何 MCP 客户端实现）通过标准化的 JSON-RPC 接口与 Ethereum 区块链数据进行交互。它充当 AI 模型和 EVM 区块链之间的桥梁，从而能够无缝访问链上数据和功能。

安装

# 克隆仓库
git clone git@github.com:Phillip-Kemper/ethereum-rpc-mpc.git
cd ethereum-rpc-mpc

# 安装依赖
yarn install

# 构建项目
yarn build

# 启动 Inspector，使用默认的 Ethereum RPC (你可以在 Inspector 设置中更改)
yarn inspector

使用

与 Cursor 一起使用

要将此 MPC 服务器与 Cursor 一起使用：

1. 在 Cursor 中，转到 Settings > Cursor Settings > MCP
2. 添加一个新的 MCP 服务器，配置如下：
   • Name: Ethereum RPC
   • Type: Command
   • Command: npx -y ethereum-rpc-mpc https://eth.llamarpc.com Ethereum 或
   • Command: node /path/to/ethereum-rpc-mpc/dist/server/index.js https://eth.llamarpc.com Ethereum

<img width="938" alt="Screenshot 2025-03-13 at 19 41 56" src="https://github.com/user-attachments/assets/f9e09d44-ea43-4ef2-9950-88300f6f9667" />

分析

您还可以使用 MCP Analytics Middleware 启用分析功能，以获取有关请求数量、请求持续时间以及所有工具和资源的错误报告的概述。 要启用它，只需传递 --analytics 标志，并额外传递 Sqlite 文件的路径。

• Command: npx -y ethereum-rpc-mpc https://eth.llamarpc.com Ethereum --analytics --db-path /Users/satoshi/Desktop/analytics.db

启动服务器

您可以通过提供 Ethereum RPC URL 和可选的链名称来启动服务器：

yarn start [RPC_URL] [CHAIN_NAME]

# 使用 npx (无需安装)
npx -y ethereum-rpc-mpc [RPC_URL] [CHAIN_NAME]

如果未提供 RPC URL，则默认使用 "https://eth.llamarpc.com"。

示例：

# 连接到 Ethereum 主网
yarn start https://eth.llamarpc.com Ethereum

# 连接到 Zircuit
yarn start https://mainnet.zircuit.com Zircuit

示例

以下是一些如何将 Ethereum RPC MPC 服务器与 Claude 一起使用的示例：

获取当前区块号

当前区块号是多少？

检查地址余额

0x742d35Cc6634C0532925a3b844Bc454e4438f44e 的 ETH 余额是多少？

获取合约信息

0x6B175474E89094C44Da98b954EedeAC495271d0F 是智能合约吗？ 如果是，它是什么类型的合约？

检索交易详情

你能给我展示一下交易 0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060 的详细信息吗？

Zircuit SLS (Sequencer Level Security) 方法

此服务器包含对 Zircuit 特定 RPC 方法的特殊支持。 这些方法默认情况下未启用，但在连接到 Zircuit 端点（链 ID：48900）时会自动激活。

支持的 Zircuit 方法包括：

• zirc_isQuarantined: 检查特定交易是否被隔离
• zirc_getQuarantined: 查询所有隔离的交易，并可选择地址过滤

这些方法对于监控交易隔离状态特别有用。

未来步骤

除了 RPC，还支持索引 API 访问

我们计划将功能扩展到基本 RPC 调用之外，以包括对索引区块链数据 API 的支持。 这将能够更有效地查询历史数据和复杂的链上分析。

多链，多 RPC 支持

未来的版本将支持同时连接到多个链和 RPC 端点，从而允许 AI 模型在单个会话中访问不同区块链的数据。

客户端实现

未来的增强功能将是开发一个客户端实现，使其更容易从各种应用程序与此 MCP 服务器进行交互。

服务器分析

我们计划添加分析功能来跟踪使用模式、流行的 RPC 方法和性能指标。 这将有助于优化服务器并提供对 AI 模型如何与区块链数据交互的见解。

许可证

MIT