Ethereum Tools for Claude MCP

用于在Claude AI中使用模型上下文协议（MCP）进行以太坊区块链分析的综合工具包。

功能

• 智能合约审计：分析合约的安全问题，验证源代码，并检测代币标准
• 钱包分析：检查ETH余额、代币持有量及交易历史
• 盈利能力追踪：计算钱包在代币和交易中的盈亏
• 区块链数据：通过简单的命令获取并分析链上数据
• 代币分析：获得全面的代币详情、价格历史及交易模式
• 推特搜索：通过关键词、用户名、日期或复杂的搜索条件查找推文，支持自然语言处理

安装

先决条件

• Node.js v16+
• Claude for Desktop
• 免费API密钥：
  • Etherscan - 用于合约验证和分析
  • Moralis - 用于钱包盈利能力及代币余额
  • Codex - 用于代币价格历史及高级分析
  • RapidAPI - 用于推特搜索功能
  • （可选）RPC提供者如Infura或使用免费公共端点

设置步骤

1. 克隆此仓库：

   git clone https://github.com/0xGval/evm-tools-mcp
   cd evm-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",
           "RAPIDAPI_KEY": "your_rapidapi_key"
         }
       }
     }
   }
   

4. 配置Claude for Desktop：

   • 在Windows上：创建或编辑 %APPDATA%\Claude\claude_desktop_config.json
   • 将您的 mcp.json 文件内容复制到此配置中

可用工具

合约分析

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

平衡与代币

• getEthBalance(address: "0x...")：获取ETH余额
• getTransactionCount(address: "0x...")：获取交易数量（nonce）
• 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)：进行全面代币分析，包括波动性和交易模式

推特搜索

• searchTwitter(query: "ethereum", section: "top", limit: 5)：使用自然语言处理的智能推特搜索

  • 自动将自然语言查询转换为正确的推特语法
  • 理解用户查询，例如“查找_gval关于hyperliquid的推文”
  • 支持高级推特搜索操作符：from:username，has:links等
  • 可选参数：min_likes，min_retweets，min_replies，start_date，end_date，language

• twitterSearchHelp(topic: "general")：获取有关推特搜索语法的帮助

  • 可用主题：“general”，“user”，“date”
  • 提供推特搜索操作符的例子和解释

实用工具

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

故障排除

常见问题：

• 环境变量未找到：确保您的API密钥正确设置在 mcp.json 中
• 提供者错误：检查您的ETH_RPC_URL是否有效且可访问
• 路径错误：确保您使用的是带有适当转义的完整绝对路径（在Windows中为 \\）
• Codex API问题：验证您的Codex API密钥有效且有权访问代币数据
• 推特搜索错误：确保您的RapidAPI密钥有权访问Twitter154 API

开发

要添加新工具：

1. 在 tools/ 目录中创建或修改文件
2. 在 main.js 中注册您的工具
3. 重启Claude for Desktop以查看更改

许可证

本项目采用MIT许可证。

致谢

• 模型上下文协议（MCP）由Anthropic提供
• Web3.js
• Moralis
• Etherscan
• Codex
• RapidAPI Twitter154