Tornado Cash MCP

一个跟踪Tornado Cash存款和取款的MCP服务器，揭示隐藏的资产轨迹和钱包交互。

功能

• 查询最新存款：检索最近的存款事件详情，包括发送方地址（from）、金额、区块编号、时间戳和承诺。
• 查询最新取款：获取最新的取款事件详情，包括接收方地址（to）、金额、区块编号和时间戳。

预备条件

• Python 3.10+
• uv（推荐的包管理器）
• 有效的The Graph API密钥以访问Tornado Cash子图

安装

1. 克隆仓库：

   git clone https://github.com/kukapay/tornado-cash-mcp.git
   cd tornado-cash-mcp
   

2. 安装依赖项 使用 uv：

   uv sync
   

3. 安装到Claude桌面：

   将服务器作为Claude桌面应用程序安装：

   uv run mcp install main.py --name "tornado-cash-mcp"
   

   配置文件参考：

   {
      "mcpServers": {
          "Tornado Cash": {
              "command": "uv",
              "args": [ "--directory", "/path/to/tornado-cash-mcp", "run", "main.py" ],
              "env": { "THEGRAPH_API_KEY": "the_graph_api_key"}               
          }
      }
   }
   

   将 /path/to/tornado-cash-mcp 替换为实际安装路径，并将 the_graph_api_key 替换为您从The Graph获得的API密钥。

工具

使用MCP Inspector UI或与兼容客户端（如Claude Desktop）集成来调用工具。

查询最新存款

示例提示：

"显示Tornado Cash最近的3笔存款。"

示例输出：

+------------+---------------+--------------+---------------------+--------------+
| from       | amount        | blockNumber  | time                | commitment   |
+============+===============+==============+=====================+==============+
| 0xdef...   |           0.1 | 12345678     | 2023-10-12 15:30:00 |  0xabc...    |
| 0xdee...   |             1 | 12345677     | 2023-10-12 15:28:20 |  0xabd...    |
| 0xdef...   |            10 | 12345676     | 2023-10-12 15:26:40 |  0xabe...    |
+------------+---------------+--------------+---------------------+--------------+

查询最新取款

示例提示：

"获取Tornado Cash最近的2笔取款。"

示例输出：

+------------+---------------+--------------+---------------------+
| to         | amount        | blockNumber  | time                |
+============+===============+==============+=====================+
| 0x789...   |             1 | 12345679     | 2023-10-13 14:40:00 |
| 0x78a...   |           100 | 12345678     | 2023-10-13 14:38:20 |
+------------+---------------+--------------+---------------------+

许可证

本项目根据MIT许可证发布。详情见LICENSE。