wallet-inspector-mcp

Wallet Inspector MCP 是一个基于 MCP（Model Context Protocol）的服务器，旨在让 AI 智能体能够检查任意钱包在主流 EVM 链和 Solana 链上的余额与链上活动。

用途

该项目为 AI 智能体提供链上数据查询能力，使其能够通过自然语言交互获取钱包的余额、活动和交易历史。

主要能力

• 多链支持：可查询 Solana、Ethereum、Polygon、Binance Smart Chain (BSC)、Base、Arbitrum 等链，以及更多 EVM 兼容链。
• 灵活输出：余额以 ASCII 表格展示，活动和交易以结构化文本展示。
• 三个核心工具：
  • get_wallet_balance：获取指定钱包地址在支持的 EVM 和 Solana 链上的余额，返回包含链、代币数量、美元价值的 ASCII 表格或错误信息。
  • get_wallet_activity：查询指定钱包地址在支持的 EVM 链上的交易活动，返回包含 chain_id、block_time、tx_hash、type、asset_type、value、value_usd 的格式化文本或错误信息。
  • get_wallet_transactions：获取指定钱包地址在支持的 EVM 和 Solana 链上的交易历史，可指定返回交易数量上限（默认 100），返回包含 chain、block_time、tx_hash、from、to、value 的格式化文本或错误信息。

使用方式

环境要求

• 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

安装到 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）查询服务器。示例自然语言查询：

• 余额查询：
  • "Check the balance of wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045."
  • "What is the balance for wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK?"
  • "Get balances for 0x1234567890abcdef1234567890abcdef12345678 on EVM chains."
• 活动查询（仅 EVM）：
  • "Show activity for wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045."
  • "Get transaction history for 0x1234567890abcdef1234567890abcdef12345678 on EVM chains."
• 交易查询：
  • "List transactions for wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 with limit 50."
  • "Show transaction history for wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK."
  • "Get the latest 10 transactions for 0x1234567890abcdef1234567890abcdef12345678."

适用场景

• AI 智能体需要查询钱包余额或链上活动时。
• 开发者或用户通过自然语言与区块链数据交互。
• 集成到支持 MCP 的客户端（如 Claude Desktop）中，扩展 AI 的链上数据访问能力。

限制

• 活动查询（get_wallet_activity）仅支持 EVM 链，不支持 Solana。
• 需要有效的 Dune SIM API Key 才能使用。
• 需要 Python 3.10+ 环境。
• 具体支持的链列表可能随项目更新而变化，资料中列举了 Solana、arbitrum、avalanche_c、base、berachain、bnb、ethereum 等。

许可

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