Wallet Inspector MCP

🚀 Wallet Inspector MCP

Wallet Inspector MCP 是一個 MCP 服務器，它使 AI 代理能夠跨主要 EVM 鏈和 Solana 鏈檢查任何錢包的餘額和鏈上活動。

✨ 主要特性

• 多鏈支持：可查詢 Solana、以太坊、Polygon、幣安智能鏈（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 筆交易。"

輸出示例

• 餘額輸出：

錢包 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 的餘額：

+----------+-----------------+-------------+
| 鏈       | 代幣數量        | 美元價值    |
+==========+=================+=============+
| ethereum | 605.371497 ETH  | $1842034.66 |
+----------+-----------------+-------------+
| polygon  | 100.500000 MATIC| $50.25      |
+----------+-----------------+-------------+
| bsc      | 10.000000 BNB   | $600.00     |
+----------+-----------------+-------------+

錢包 DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK 的餘額：

+----------+---------------+-------------+
| 鏈       | 代幣數量      | 美元價值    |
+==========+===============+=============+
| solana   | 1.000000 SOL  | $20.50      |
+----------+---------------+-------------+

• 活動輸出（僅 EVM 鏈）：

錢包 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 的活動：

鏈 ID：8453
區塊時間：2025-02-20T13:52:29+00:00
交易哈希：0x184544c8d67a0cbed0a3f04abe5f958b96635e8c743c070f70e24b1c06cd1aa6
類型：接收
資產類型：ERC20
價值：123.069653 ENT
美元價值：$0.14

• 交易輸出：

錢包 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 的交易：

鏈：ethereum
區塊時間：2023-11-07T05:31:56Z
交易哈希：0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
發送方：0xd8da6bf26964af9d7eed9e03e53415d37aa96045
接收方：0x1234567890abcdef1234567890abcdef12345678
價值：0.000320 ETH

錢包 DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK 的交易：

鏈：solana
區塊時間：2023-03-28T09:20:00Z
交易哈希：5SzSbWKM9yZC7cCGMhUhvnYdWQytrk9NBaWwug1gQBKKwNEBvBKqPSfVeYYnZwUuUyvcCHgYhDkTRrB6YBfwzfv8
發送方：DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK
接收方：9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
價值：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...'）。
• 返回值：包含活動詳情（鏈 ID、區塊時間、交易哈希、類型、資產類型、價值、美元價值）的格式化文本或錯誤消息。
• 支持的鏈：Arbitrum、arbitrum、avalanche_c、base、berachain、bnb、ethereum 等。

get_wallet_transactions

• 描述：獲取指定錢包地址在支持的 EVM 和 Solana 區塊鏈上的交易歷史。
• 參數：
  • wallet_address (str)：要查詢的錢包地址（例如，EVM 鏈使用 '0x123...'，Solana 使用 'DYw8jCT...'）。
  • limit (int, 可選)：返回的最大交易數量（默認值：100）。
• 返回值：包含交易詳情（鏈、區塊時間、交易哈希、發送方、接收方、價值）的格式化文本或錯誤消息。
• 支持的鏈：Solana、arbitrum、arbitrum、avalanche_c、base、berachain、bnb、ethereum 等。

📄 許可證

本項目採用 MIT 許可證。詳情請參閱 LICENSE 文件。