使用说明
x402 MCP服务器
一 MCP(模型上下文协议) 该服务器将x402 DeFi数据端点作为AI代理的工具公开。
什么是MCP?
MCP是一个开放标准,允许AI应用程序(Claude、Cursor、OpenClaw等)通过统一的协议发现和使用工具。将其视为AI的USB-C端口——任何兼容的客户端都可以插入任何兼容的服务器。
此服务器包装x402 API(每次呼叫付费DeFi数据),以便任何兼容MCP的AI代理都可以:
- 发现可用的数据端点
- 用适当的参数调用它们
- 获得结构化结果
工具
| 工具 | 说明 |
|---|---|
get_crypto_prices |
当前价格,24小时变化,热门 |
analyze_whale_concentration |
代币持有者集中度和鲸鱼风险(参数: token) |
compare_funding_rates |
跨交易所的Perp融资利率+套利机会 |
list_available_endpoints |
发现所有可用的x402 API端点 |
先决条件
- x402 API服务器必须运行在
localhost:4020(或设置X402_API_URL) - Node.js 18+
设置
cd x402-mcp-server
npm install
连接到克劳德桌面
增添 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"x402-defi": {
"command": "node",
"args": ["/absolute/path/to/x402-mcp-server/src/index.js"],
"env": {
"X402_API_URL": "http://localhost:4020"
}
}
}
}
连接到光标
增添 .cursor/mcp.json 在您的项目(或全局设置)中:
{
"mcpServers": {
"x402-defi": {
"command": "node",
"args": ["/absolute/path/to/x402-mcp-server/src/index.js"]
}
}
}
连接到OpenClaw
openclaw mcp add x402-defi -- node /absolute/path/to/x402-mcp-server/src/index.js
本地测试
# Start the x402 API server first
cd ../x402-api-server && npm start &
# Test MCP server with the MCP inspector
npx @modelcontextprotocol/inspector node src/index.js
# Or pipe JSON-RPC manually:
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | node src/index.js
建筑
AI Agent (Claude/Cursor/OpenClaw)
↕ MCP (stdio, JSON-RPC)
x402 MCP Server (this)
↕ HTTP
x402 API Server (localhost:4020)
↕ x402 protocol (HTTP 402 + USDC)
DeFi Data Sources
许可证
麻省理工学院