关键词

钱包余额区块链活动交易历史EVM链Solana链

项目简介

这是一个基于 Model Context Protocol (MCP) 的后端服务，旨在使大型语言模型 (LLM) 能够查询区块链钱包的余额、活动和交易历史。它支持多种主流链，包括EVM兼容链（如以太坊、Polygon、BSC）和Solana。

主要功能点

  • 多链支持: 可以查询以太坊、Polygon、币安智能链 (BSC)、Base、Arbitrum 等主流EVM链以及Solana链上的数据。
  • 钱包余额查询: 获取指定钱包地址在各支持链上的代币余额及其估值的ASCII表格报告。
  • 链上活动查询: 查看EVM兼容钱包地址的近期链上活动详情（如接收的资产、交易类型等）。
  • 交易历史查询: 获取指定钱包地址在支持链上的交易列表，并可指定返回数量上限。

安装步骤

  1. 准备工作: 确保您的系统已安装 Python 3.10 或更高版本。您需要一个 Dune SIM API Key，可从 Dune Analytics 网站获取。项目推荐使用 'uv' 或 'pip' 作为依赖管理器。
  2. 克隆仓库: 打开终端或命令提示符，使用 'git clone https://github.com/kukapay/wallet-inspector-mcp.git' 命令下载项目代码，然后进入项目目录 'cd wallet-inspector-mcp'。
  3. 安装依赖: 在项目目录中，如果您使用 'uv'（推荐），运行 'uv async'。如果您使用 'pip'，运行 'pip install mcp[cli] python-dotenv tabulate'。

服务器配置 (供 MCP 客户端使用)

这是一个 MCP 服务器，需要通过兼容的 MCP 客户端（如 Claude Desktop 或其他支持 MCP 的 LLM 应用）进行连接和交互。MCP 客户端启动时需要知道如何启动这个服务器进程并与其通信。

典型的客户端配置会包含以下信息，指定服务器的名称、启动命令、参数和必要的环境变量。例如，对于一个名为 "Wallet Inspector" 的服务器，客户端配置可能如下所示：

{
   "mcpServers": {
       "Wallet Inspector": { // 服务器的名称
           "command": "用于启动Python环境和主程序的命令，例如 'uv' 或 'python'",
           "args": [
               "--directory", "/path/to/wallet-inspector-mcp", // 服务器代码所在的完整路径，请替换为您的实际安装路径
               "run", "main.py" // 启动服务器的主脚本文件
           ],
           "env": {
               "DUNE_SIM_API_KEY": "your_dune_sim_api_key_here" // 运行服务器所需的环境变量，请替换为您的实际 Dune SIM API Key
           }
       }
   }
}

请根据您的实际 Python 环境配置、项目安装路径和获取到的 Dune SIM API Key 修改上述配置，并将其添加到您的 MCP 客户端的服务器配置中。

基本使用方法

一旦服务器在 MCP 客户端中成功配置并运行，您就可以通过与 LLM 客户端交互来使用其功能。LLM 客户端会根据您的自然语言指令，自动识别并调用服务器暴露的相应工具（如查询余额、活动或交易）。

例如，您可以尝试向 LLM 客户端提出以下类型的查询：

  • 询问某个钱包地址在各支持链上的余额，如："Check the balance of wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045." 或 "What is the balance for wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK?"
  • 查询某个 EVM 钱包的近期活动详情，如："Show activity for wallet 0x123... on EVM chains."
  • 获取某个钱包的交易历史列表，如："List transactions for wallet DYw8jCT... with limit 20." 或 "Get the latest 10 transactions for 0x1234567890abcdef1234567890abcdef12345678."

服务器将执行相应的链上数据查询，并将结果（格式化的文本或表格）返回给 LLM 客户端，最终由 LLM 呈现给您。

信息

分类

网页与API

访问项目