Tornado Cash MCP

🚀 Tornado Cash MCP

Tornado Cashの入出金を追跡し、隠された資産の軌跡やウォレット間のやり取りを明らかにするMCPサーバーです。

✨ 主な機能

• 最新の入金を照会：最新の入金イベントを取得し、送信者アドレス (from)、金額、ブロック番号、タイムスタンプ、コミットメントを含む詳細情報を取得できます。
• 最新の出金を照会：最新の出金イベントを取得し、受信者アドレス (to)、金額、ブロック番号、タイムスタンプを含む詳細情報を取得できます。

📦 インストール

前提条件

• Python 3.10以上
• uv（推奨パッケージマネージャー）
• Tornado Cash Subgraphにアクセスするための有効な The Graph APIキー

インストール手順

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インスペクター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 を参照してください。