Wallet Inspector MCP

Wallet Inspector MCP

主要な EVM チェーンと Solana チェーン全体で、あらゆるウォレットの残高とオンチェーンアクティビティを調べられる AI エージェント向けの MCP サーバーです。

機能

• マルチチェーン対応：Solana、Ethereum、Polygon、Binance Smart Chain（BSC）、Base、Arbitrum などに対応しています。
• 柔軟な出力：残高は 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）を使ってサーバーに問い合わせます。自然言語での問い合わせ例：

• 残高の問い合わせ：

  • 「ウォレット 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 の残高を確認してください。」
  • 「ウォレット DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK の残高はいくらですか？」
  • 「EVM チェーン上の 0x1234567890abcdef1234567890abcdef12345678 の残高を取得してください。」

• アクティビティの問い合わせ（EVM のみ）：

  • 「ウォレット 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 のアクティビティを表示してください。」
  • 「EVM チェーン上の 0x1234567890abcdef1234567890abcdef12345678 のトランザクション履歴を取得してください。」

• トランザクションの問い合わせ：

  • 「ウォレット 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 のトランザクションを、上限を 50 件にして一覧表示してください。」
  • 「ウォレット DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK のトランザクション履歴を表示してください。」
  • 「0x1234567890abcdef1234567890abcdef12345678 の最新 10 件のトランザクションを取得してください。」

出力例

• 残高の出力：

  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 および Solana ブロックチェーン上で、指定したウォレットアドレスの残高を取得します。
• パラメーター：
  • wallet_address (str)：問い合わせるウォレットアドレス（例：EVM チェーンの場合は '0x123...'、Solana の場合は 'DYw8jCT...'）。
• 戻り値：残高の詳細（チェーン、トークン量、米ドル換算額）を示す ASCII テーブル、またはエラーメッセージ。
• 対応チェーン：Solana、arbitrum、arbitrum、avalanche_c、base、berachain、bnb、ethereum など。

get_wallet_activity

• 説明：対応する EVM ブロックチェーン上で、指定したウォレットアドレスのトランザクションアクティビティを問い合わせます。
• パラメーター：
  • wallet_address (str)：問い合わせる EVM 互換ウォレットアドレス（例：'0x123...'）。
• 戻り値：アクティビティの詳細（chain_id、block_time、tx_hash、type、asset_type、value、value_usd）を含む書式付きテキスト、またはエラーメッセージ。
• 対応チェーン：Arbitrum、arbitrum、avalanche_c、base、berachain、bnb、ethereum など。

get_wallet_transactions

• 説明：対応する EVM および Solana ブロックチェーン上の指定したウォレットアドレスのトランザクション履歴を取得します。
• パラメーター：
  • wallet_address (str)：照会するウォレットアドレス（EVM チェーンの場合は「0x123...」、Solana の場合は「DYw8jCT...」など）。
  • limit (int, optional)：返すトランザクションの最大数（デフォルト：100）。
• 戻り値：トランザクションの詳細（chain、block_time、tx_hash、from、to、value）を含む整形済みテキスト、またはエラーメッセージ。
• 対応チェーン：Solana、arbitrum、arbitrum、avalanche_c、base、berachain、bnb、ethereum など。

ライセンス

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