🚀 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。
安装步骤
- 克隆仓库：
git clone https://github.com/kukapay/wallet-inspector-mcp.git
cd wallet-inspector-mcp
- 安装依赖：
推荐使用
uv：
uv async
或者使用 pip：
pip install mcp[cli] python-dotenv tabulate
- 安装到 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 文件。