🚀 Tornado Cash MCP
Tornado Cash MCP是一个MCP服务器，用于跟踪Tornado Cash的存款和取款操作，以揭示隐藏的资产轨迹和钱包交互情况。
✨ 主要特性
- 查询最新存款信息：可检索最新的存款事件，包含发送方地址（
from）、金额、区块编号、时间戳和承诺等详细信息。 - 查询最新取款信息：能获取最新的取款事件，包含接收方地址（
to）、金额、区块编号和时间戳等详细信息。
📦 安装指南
前提条件
- Python 3.10 及以上版本
- uv（推荐的包管理器）
- 一个有效的 The Graph API 密钥，用于访问 Tornado Cash 子图
安装步骤
-
克隆仓库：
git clone https://github.com/kukapay/tornado-cash-mcp.git cd tornado-cash-mcp -
使用
uv安装依赖：uv sync -
安装到 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 文件。