Wallet Inspector MCP

🚀 Wallet Inspector MCP

このMCPサーバーは、AIエージェントが主要なEVMチェーンとソルアナチェーンを横断して、任意のウォレットの残高とオンチェーンアクティビティを調査できるようにします。

✨ 主な機能

• マルチチェーン対応：ソルアナ、イーサリアム、ポリゴン、バイナンススマートチェーン（BSC）、Base、アービトラムなどのチェーンをクエリできます。
• 柔軟な出力：残高はASCIIテーブルで、アクティビティやトランザクションは構造化テキストで出力されます。

📦 インストール

前提条件

• Python：バージョン3.10以上。
• Dune SIM APIキー：Dune Analyticsから取得してください。
• 依存関係マネージャー：uv（推奨）またはpip。

セットアップ

1. リポジトリのクローン：

   git clone https://github.com/kukapay/wallet-inspector-mcp.git
   cd wallet-inspector-mcp
   

2. 依存関係のインストール： uvを使用する場合（推奨）：

   uv async
   

   またはpipを使用する場合：

   pip install mcp[cli] python-dotenv tabulate
   

3. Claude Desktopへのインストール： サーバーをClaude Desktopアプリケーションとしてインストールします。

   uv run mcp install cli.py --name "Wallet Inspector"
   

   参考としての設定ファイル：

   {
       "mcpServers": {
           "Wallet Inspector": {
               "command": "uv",
               "args": [ "--directory", "/path/to/wallet-inspector-mcp", "run", "main.py" ],
               "env": { "DUNE_SIM_API_KEY": "your_dune_sim_api_key_here"},               
           }
       }
   }
   

   /path/to/wallet-inspector-mcpを実際のインストールパスに、your_dune_sim_api_key_hereをあなたのDune SIM APIキーに置き換えてください。

💻 使用例

サーバーとのやり取り

MCP互換のクライアント（例：Claude Desktop CLI）を使用してサーバーにクエリを送信します。自然言語クエリの例：

• 残高クエリ：
  • "Check the balance of wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045."
  • "What is the balance for wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK?"
  • "Get balances for 0x1234567890abcdef1234567890abcdef12345678 on EVM chains."
• アクティビティクエリ（EVMのみ）：
  • "Show activity for wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045."
  • "Get transaction history for 0x1234567890abcdef1234567890abcdef12345678 on EVM chains."
• トランザクションクエリ：
  • "List transactions for wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 with limit 50."
  • "Show transaction history for wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK."
  • "Get the latest 10 transactions for 0x1234567890abcdef1234567890abcdef12345678."

出力例

• 残高出力：

  Wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 balances:
  
  +----------+-----------------+-------------+
  | Chain    | Token Amount    | USD Value   |
  +==========+=================+=============+
  | ethereum | 605.371497 ETH  | $1842034.66 |
  +----------+-----------------+-------------+
  | polygon  | 100.500000 MATIC| $50.25      |
  +----------+-----------------+-------------+
  | bsc      | 10.000000 BNB   | $600.00     |
  +----------+-----------------+-------------+
  
  Wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK balances:
  
  +----------+---------------+-------------+
  | Chain    | Token Amount  | USD Value   |
  +==========+===============+=============+
  | solana   | 1.000000 SOL  | $20.50      |
  +----------+---------------+-------------+
  

• アクティビティ出力（EVMのみ）：

  Wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 activity:
  
  Chain ID: 8453
  Block Time: 2025-02-20T13:52:29+00:00
  Tx Hash: 0x184544c8d67a0cbed0a3f04abe5f958b96635e8c743c070f70e24b1c06cd1aa6
  Type: Receive
  Asset Type: ERC20
  Value: 123.069653 ENT
  USD Value: $0.14
  

• トランザクション出力：

  Wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 transactions:
  
  Chain: ethereum
  Block Time: 2023-11-07T05:31:56Z
  Tx Hash: 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
  From: 0xd8da6bf26964af9d7eed9e03e53415d37aa96045
  To: 0x1234567890abcdef1234567890abcdef12345678
  Value: 0.000320 ETH
  
  Wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK transactions:
  
  Chain: solana
  Block Time: 2023-03-28T09:20:00Z
  Tx Hash: 5SzSbWKM9yZC7cCGMhUhvnYdWQytrk9NBaWwug1gQBKKwNEBvBKqPSfVeYYnZwUuUyvcCHgYhDkTRrB6YBfwzfv8
  From: DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK
  To: 9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
  Value: 0.010000 SOL
  

📚 ドキュメント

get_wallet_balance

• 説明：指定されたウォレットアドレスの残高を、サポートされているEVMおよびソルアナブロックチェーン全体で取得します。
• パラメーター：
  • wallet_address (str)：クエリするウォレットアドレス（例：EVMチェーンの場合は'0x123...'、ソルアナの場合は'DYw8jCT...'）。
• 戻り値：残高の詳細（チェーン、トークン量、USD価値）を含むASCIIテーブル、またはエラーメッセージ。
• サポートされているチェーン：ソルアナ、アービトラム、アバランチェ_c、Base、ベラチェーン、BNB、イーサリアムなど。

get_wallet_activity

• 説明：指定されたウォレットアドレスのトランザクションアクティビティを、サポートされているEVMブロックチェーンでクエリします。
• パラメーター：
  • wallet_address (str)：クエリするEVM互換のウォレットアドレス（例：'0x123...'）。
• 戻り値：アクティビティの詳細（チェーンID、ブロック時間、トランザクションハッシュ、タイプ、アセットタイプ、価値、USD価値）を含む整形テキスト、またはエラーメッセージ。
• サポートされているチェーン：アービトラム、アバランチェ_c、Base、ベラチェーン、BNB、イーサリアムなど。

get_wallet_transactions

• 説明：指定されたウォレットアドレスのトランザクション履歴を、サポートされているEVMおよびソルアナブロックチェーンで取得します。
• パラメーター：
  • wallet_address (str)：クエリするウォレットアドレス（例：EVMチェーンの場合は'0x123...'、ソルアナの場合は'DYw8jCT...'）。
  • limit (int, オプション)：返すトランザクションの最大数（デフォルト：100）。
• 戻り値：トランザクションの詳細（チェーン、ブロック時間、トランザクションハッシュ、送信元、送信先、価値）を含む整形テキスト、またはエラーメッセージ。
• サポートされているチェーン：ソルアナ、アービトラム、アバランチェ_c、Base、ベラチェーン、BNB、イーサリアムなど。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。