Tornado Cash MCP

🚀 Tornado Cash MCP

Tornado Cash MCP是一个MCP服务器，用于跟踪Tornado Cash的存款和取款操作，以揭示隐藏的资产轨迹和钱包交互情况。

✨ 主要特性

• 查询最新存款信息：可检索最新的存款事件，包含发送方地址（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 Desktop：

   将服务器作为 Claude Desktop 应用程序进行安装：

   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）集成来调用工具。

基础用法

查询最新存款信息

示例输入：

"Show me the latest 3 deposits from Tornado Cash."

示例输出：

+------------+---------------+--------------+---------------------+--------------+
| 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...     |
+------------+---------------+--------------+---------------------+--------------+

查询最新取款信息

示例输入：

"Get the most recent 2 withdrawals from Tornado Cash."

示例输出：

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

📄 许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。