evm-mcp-tools

🚀 以太坊工具用于Claude MCP

这是一个全面的以太坊区块链分析工具包，可直接在Claude AI中使用模型上下文协议（MCP），助力用户高效分析以太坊区块链数据。

🚀 快速开始

本工具包可直接在Claude AI中使用模型上下文协议（MCP），让您轻松开展以太坊区块链分析工作。

✨ 主要特性

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

📦 安装指南

先决条件

• Node.js v16+版本
• Claude桌面版
• 免费API密钥：
  • Etherscan - 用于合约验证和分析
  • Moralis - 用于钱包盈利能力及代币余额查询
  • Codex - 用于代币价格历史和高级分析
  • RapidAPI - 提供Twitter搜索功能
  • （可选）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桌面版：
   • 在Windows系统中：创建或编辑 %APPDATA%\Claude\claude_desktop_config.json
   • 将mcp.json文件内容复制到此配置文件中

💻 使用示例

基础用法

以下是一些常用工具的调用示例：

# 对智能合约进行安全审核
auditContract(address: "0x...")

# 获取ETH余额
getEthBalance(address: "0x...")

# 获取交易数量（非竞赛数）
getTransactionCount(address: "0x...")

# 获取指定地址在以太坊网络中的代币余额
getTokensBalance(address: "0x...", chain: "eth", blockNumber: null)

# 通过地址查找所有相关的代币交易记录
getTokenTxByAddress(address: "0x...")

# 通过地址查找所有相关的ETH主网交易记录
getEthTxByAddress(address: "0x...")

📚 详细文档

可用工具

合约分析

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

资产与代币

• getEthBalance(address: "0x...")：获取ETH余额。
• getTransactionCount(address: "0x...")：获取交易数量（非竞赛数）。
• getTokensBalance(address: "0x...", chain: "eth", blockNumber: null)：获取指定地址在以太坊网络中的代币余额。

交易记录

• getTokenTxByAddress(address: "0x...")：通过地址查找所有相关的代币交易记录。
• getEthTxByAddress(address: "0x...")：通过地址查找所有相关的ETH主网交易记录。

开发指南

添加新工具：

1. 在tools/目录下创建或修改文件。
2. 在main.js中注册新的工具。
3. 重启Claude桌面版以显示更新。

📄 许可证

本项目采用MIT许可证。

致谢

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