Web3 MCP

一个基于Ankr高级API的MCP服务器实现。

概述

FastMCP是一个模型上下文协议（MCP）服务器，提供对Ankr高级API的全面支持，用于访问多条区块链的数据，包括以太坊、BSC、Polygon、Avalanche等。它允许LLM与多条链上的区块链数据进行交互。

MCP客户端配置

{
  "mcpServers": {
    "web3": {
      "command": "uvx",
      "args": [
        "web3-mcp"
      ],
      "env": {
        "ANKR_ENDPOINT": "https://rpc.ankr.com/...",
      }
    }
  }
}

功能

• Ankr高级API所有端点的完整包装
• NFT API：获取NFT元数据、持有者、转让和所有权信息
• 查询API：访问区块链统计信息、区块、日志和事务数据
• Token API：获取代币余额、价格、持有者和转账记录
• 支持多条区块链网络

安装

# 克隆仓库
git clone https://github.com/tumf/web3-mcp.git
cd web3-mcp

# 使用uv进行安装
uv pip install -e .

配置

设置以下环境变量：

# 必填
export ANKR_ENDPOINT="你的Ankr RPC端点"

# 可选但推荐用于身份验证请求
export ANKR_PRIVATE_KEY="你的私钥"

使用方法

运行服务器

from web3_mcp.server import init_server

# 初始化MCP服务器
mcp = init_server(
    name="Ankr MCP",
    endpoint="你的Ankr端点",  # 可选，默认使用ANKR_ENDPOINT环境变量
    private_key="你的私钥"  # 可选，默认使用ANKR_PRIVATE_KEY环境变量
)

# 运行服务器
mcp.run()

与FastMCP CLI一起使用

# 首先设置环境变量
export ANKR_ENDPOINT="你的Ankr端点"
export ANKR_PRIVATE_KEY="你的私钥"

# 运行服务器
python -m web3_mcp

API分类

NFT API

• get_nfts_by_owner：获取某个钱包地址的NFT
• get_nft_metadata：获取特定NFT的元数据
• get_nft_holders：获取特定NFT系列的持有者
• get_nft_transfers：获取NFT的转让记录

查询API

• get_blockchain_stats：获取区块链统计信息
• get_blocks：获取区块信息
• get_logs：获取区块链日志
• get_transactions_by_hash：通过哈希获取事务
• get_transactions_by_address：通过地址获取事务
• get_interactions：获取钱包与合约的交互记录

Token API

• get_tokens_by_owner：获取某个钱包地址的代币
• get_token_info：获取特定代币的信息
• get_token_transfers：获取代币的转让记录
• get_token_price：获取代币的价格信息

许可证

MIT