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 文件。