ZetaChain MCP服务器
内置于TypeScript中的模型上下文协议(MCP)服务器,使LLM代理能够使用公共RPC端点访问ZetaChain区块链数据。该服务器为ZetaChain公开了与EVM兼容的核心方法和分析提示,使LLM能够轻松地与ZetaChain钱包和合约进行交互。
例子:
📦 安装
使用您最喜欢的软件包管理器进行全局安装:```bash
With npm
npm install -g zetachain-mcp-server
With yarn
yarn global add zetachain-mcp-server
With pnpm
pnpm add -g zetachain-mcp-server
With bun
bun add -g zetachain-mcp-server
______________________________________________________________________
## 🚀 快速开始
### 用于游标IDE
在全球范围内安装后 `npm install -g zetachain-mcp-server`,您可以直接在游标中使用CLI命令 `mcp.json` 配置:```json
{
"mcpServers": {
"zetachain-mcp": {
"command": "zetachain-mcp-server"
}
}
}
不需要API键或环境变量。 默认情况下,服务器使用ZetaChain的公共RPC端点。
🧑💻 与Claude Desktop一起使用
> 重要提示: Claude Desktop无法使用全局安装的npm包。您必须在本地安装该包,并提供可执行文件的完整路径。
安装
- 将此存储库克隆或下载到本地计算机
- 导航到项目目录并安装依赖项:```bash
cd zetachain-mcp
npm install
npm run build
### 配置
1. 打开 **克劳德桌面** 应用
1. 首选 **克劳德** > **设置** > **开发者**
1. 编辑 `claude_desktop_config.json` 文件并添加以下配置:```json
{
"mcpServers": {
"zetachain-mcp": {
"command": "node",
"args": [
"/absolute/path/to/zetachain-mcp/build/index.js"
]
}
}
}
替换 /absolute/path/to/zetachain-mcp/ 使用项目目录的实际绝对路径。
示例路径:
- macOS/Linux:
/Users/yourname/projects/zetachain-mcp/build/index.js - 窗户:
C:\\Users\\yourname\\projects\\zetachain-mcp\\build\\index.js
-
重新启动Claude Desktop以使更改生效
-
让Claude Desktop执行ZetaChain任务 (见以下示例)
📝 代理交互示例
- 检查钱包余额:```
Give the balance of the 0x1234...abcd address on ZetaChain
- **分析合同:**```
Analyze 0x5678...efgh on ZetaChain
- 获取当前天然气价格:```
Analyze the current gas prices on ZetaChain
______________________________________________________________________
## 📦 项目结构```bash
├── chains.ts # ZetaChain configuration and public RPC endpoint
├── clients.ts # Viem public client creator for RPC connections
├── index.ts # Main entry point that sets up the MCP server
├── package.json # Package configuration
├── prompts.ts # Defines LLM prompts for blockchain analysis tasks
├── resources.ts # External references and helpers
├── tools.ts # Implements the EVM RPC methods as MCP tools
└── tsconfig.json # TypeScript configuration
⚡ 特性
- MCP兼容:使用用于LLM代理集成的模型上下文协议SDK构建
- ZetaChain支架:仅与ZetaChain主网合作
- 核心EVM方法:包括
eth_getBalance,eth_getCode,以及eth_gasPrice对于ZetaChain - LLM提示:用于钱包分析、合同检查和天然气价格评估的预构建提示
- 不需要API密钥:使用所需的ZetaChain的公共RPC端点-no.env或API密钥设置
🛠️ MCP工具
- eth_getBalance
- 描述:获取地址的ZETA代币余额
- 参数:
address:要检查的ZetaChain地址chain:要查询的链(必须是zetachain)- 退货:
- 地址、链名、wei余额、带符号的格式化余额
- eth_getCode
- 描述:检测地址是合约还是钱包
- 参数:
address:要检查的ZetaChain地址chain:要查询的链(必须是zetachain)- 退货:
- 地址信息、合约状态、字节码大小
- eth_gasPrice
- 描述:在ZetaChain上获取当前的天然气价格
- 参数:
chain:要查询的链(必须是zetachain)- 退货:
- 链名、威、圭天然气价格、时间戳
💡 MCP提示
- 支票钱包
- 描述:分析钱包余额和上下文的指南
- 参数:
address:要检查的ZetaChain地址chain:要查询的链(必须是zetachain)- 功能:指导法学硕士获得余额,检查是否是合同,然后提供分析
- 检查合同
- 描述:及时进行合同代码自检和分析
- 参数:
address:要检查的ZetaChain地址chain:要查询的链(必须是zetachain)- 功能:指导LLM验证代码存在,分析合约大小和平衡
- 气体分析
- 描述:分析天然气价格趋势并评估时机
- 参数:
chain:要查询的链(必须是zetachain)- 功能:指导法学硕士分析当前天然气价格并提供建议
📚 MCP资源
服务器提供对这些资源的访问:
evm://docs/gas-reference-ZetaChain的天然气价格参考数据evm://docs/block-explorers-ZetaChain的区块浏览器URLevm://docs/supported-chains-支撑链(ZetaChain)
