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桌面：

   将服务器作为Claude桌面应用程序安装：

   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的余额是多少？"
  • "获取钱包0x1234567890abcdef1234567890abcdef12345678在EVM链上的余额。"

• 活动查询（仅限EVM）：

  • "显示钱包0xd8da6bf26964af9d7eed9e03e53415d37aa96045的活动。"
  • "获取钱包0x1234567890abcdef1234567890abcdef12345678在EVM链上的交易历史。"

• 交易查询：

  • "列出钱包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)：要查询的钱包地址（例如，'0x123...'用于EVM链或'DYw8jCT...'用于Solana）。
• 返回值：包含余额详情（链、代币数量、美元价值）的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)：要查询的钱包地址（例如，'0x123...'用于EVM链或'DYw8jCT...'用于Solana）。
  • limit (int, 可选)：返回的最大交易数（默认：100）。
• 返回值：包含交易详情（链、区块时间、交易哈希、发送方、接收方、数量）的格式化文本或错误消息。
• 支持的链：Solana、arbitrum、arbitrum、avalanche_c、base、berachain、bnb、ethereum等。

许可证

本项目采用MIT许可证。详情见LICENSE文件。