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 文件。