AI导哈

钱包检查器服务

一个支持AI代理检查多链钱包余额和链上活动的MCP服务器，适用于EVM和Solana链。

  • by kukapay
  • Python
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 kukapay/wallet-inspector-mcp

使用说明

钱包检查器MCP

MCP服务器，使AI代理能够检查主要EVM链和Solana链上的任何钱包余额和链上活动。

特性

  • 多链支持：查询Solana、以太坊、Polygon、币安智能链（BSC）、Base、Arbitrum等。
  • 灵活的输出：ASCII表中的余额，结构化文本中的活动和交易。

安装

先决条件

  • python：版本3.10或更高版本。
  • Dune SIM API密钥：从获取 沙丘分析.
  • 依赖关系管理器: 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应用程序：

    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笔交易。”

输出示例

  • 平衡输出:

    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…”）。
  • 退货：包含余额详细信息（链、代币金额、美元价值）或错误消息的ASCII表。
  • 支撑链：Solana、arbitrum、arbitrom、雪崩_c、base、berachain、bnb、以太坊等。

get_wallet_activity

  • 描述：查询支持的EVM区块链上指定钱包地址的交易活动。
  • 参数:
    • wallet_address （str）：要查询的EVM兼容钱包地址（例如，“0x123…”）。
  • 退货：带有活动详细信息（chain_id、block_time、tx_hash、type、asset_type、value、value_usd）或错误消息的格式化文本。
  • 支撑链：Arbitrum、Arbitrum、雪崩_c、base、berachain、bnb、以太坊等。

get_wallet_transactions

  • 描述：获取支持的EVM和Solana区块链上指定钱包地址的交易历史。
  • 参数:
    • wallet_address （str）：要查询的钱包地址（例如，EVM链为“0x123…”，Solana为“DYw8jCT…”）。
    • limit （int，可选）：要返回的最大事务数（默认值：100）。
  • 退货：带有交易详细信息（链、block_time、tx_hash、from、to、value）或错误消息的格式化文本。
  • 支撑链：Solana、arbitrum、arbitrom、雪崩_c、base、berachain、bnb、以太坊等。

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。

相关 MCP