Wallet Inspector MCP

Wallet Inspector MCP

一个 MCP 服务，可帮助 AI Agent 检查主要 EVM 链和 Solana 链上任意钱包的余额及链上活动。

功能

• 多链支持：查询 Solana、Ethereum、Polygon、Binance Smart Chain（BSC）、Base、Arbitrum 等链。
• 灵活的输出：以 ASCII 表格显示余额，以结构化文本显示活动和交易。

安装

前提条件

• Python：版本 3.10 或更高。
• Dune SIM API Key：从 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 Key。

使用方法

与服务交互

使用兼容 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...'）。
• 返回值：包含余额详情（链、代币数量、USD 价值）的 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，可选）：要返回的最大交易数量（默认值：100）。
• 返回值：包含交易详情（chain、block_time、tx_hash、from、to、value）的格式化文本，或错误消息。
• 支持的链：Solana、arbitrum、arbitrum、avalanche_c、base、berachain、bnb、ethereum 等。

许可证

本项目基于 MIT 许可证授权。详情请参阅 LICENSE 文件。