ethereum-tools

Claude MCP 的以太坊工具

使用模型上下文协议 (MCP) 直接在 Claude AI 内进行以太坊区块链分析的综合工具包。

特征

• 智能合约审计：分析合约的安全问题、验证源代码并检测代币标准
• 钱包分析：检查 ETH 余额、代币持有量和交易历史记录
• 盈利能力跟踪：计算代币和交易的钱包利润/损失
• 区块链数据：使用简单命令获取和分析链上数据
• 代币分析：获取全面的代币详细信息、价格历史和交易模式

安装

先决条件

• Node.js v16+
• 克劳德桌面版
• 免费 API 密钥：
  • Etherscan——用于合同验证和分析
  • Moralis - 用于钱包盈利能力和代币余额
  • Codex - 用于代币价格历史和高级分析
  • （可选）RPC 提供商（例如Infura）或使用免费的公共端点

设置步骤

1. 克隆此存储库：
   git clone https://github.com/giovannialbero1992/ethereum-tools-mcp cd ethereum-tools-mcp
2. 安装依赖项：
   npm install
3. 创建您的配置：
   • 将mcp.json.example复制到mcp.json
   • 编辑mcp.json以包含您的 API 密钥和正确的文件路径
   { "mcpServers": { "ethereum-tools": { "command": "node", "args": ["YOUR_ABSOLUTE_PATH_TO/main.js"], "env": { "ETH_RPC_URL": "https://eth.llamarpc.com", "MORALIS_API_KEY": "your_moralis_api_key", "ETHERSCAN_API_KEY": "your_etherscan_api_key", "CODEX_API_KEY": "your_codex_api_key" } } } }
4. 配置 Claude 桌面版：
   • 在 Windows 上：创建/编辑%APPDATA%\Claude\claude_desktop_config.json
   • 将mcp.json文件的内容复制到此配置中

可用工具

合同分析

• auditContract(address: "0x...") ：对智能合约进行安全审计

余额和代币

• getEthBalance(address: "0x...") : 获取ETH余额
• getTransactionCount(address: "0x...") ：获取交易计数（随机数）
• getTokensBalance(address: "0x...", chain: "eth", excludeSpam: true) ：获取所有代币余额

盈利能力

• getWalletPnl(address: "0x...", chain: "eth") : 分析钱包盈亏

代币分析

• getTokenInfo(address: "0x...", networkId: 1) ：获取基本代币信息，包括名称、符号和供应量
• getTokenPriceHistory(address: "0x...", networkId: 1, days: 7, resolution: "1D") ：获取历史价格数据
• analyzeToken(address: "0x...", networkId: 1, days: 30) ：执行全面的代币分析，包括波动性和交易模式

公用事业

• add(a: 1, b: 2) ：简单实用函数示例

故障排除

常见问题：

• 未找到环境变量：请确保您的 API 密钥在mcp.json中正确设置
• 提供商错误：检查您的 ETH_RPC_URL 是否有效且可访问
• 路径错误：确保您使用完整的绝对路径，并在 Windows 中正确转义（ \\ ）
• Codex API 问题：验证您的 Codex API 密钥是否有效并有权访问令牌数据

发展

要添加新工具：

1. 在tools/目录中创建或修改文件
2. 在main.js中注册你的工具
3. 重新启动 Claude for Desktop 即可看到更改

执照

该项目已获得 MIT 许可。

致谢

• Anthropic 的模型上下文协议 (MCP)
• Web3.js
• 莫拉利斯
• Etherscan
• 法典