Web3 MCP

Web3 MCP

一个封装 Ankr Advanced API 的 MCP 服务实现。

概述

FastMCP 是一个 Model Context Protocol (MCP) 服务，可访问 Ankr 的 Advanced API，获取区块链数据。它允许大模型与多个链上的区块链数据交互，包括 Ethereum、BSC、Polygon、Avalanche 等。

MCP 客户端设置

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

功能

• 完整封装所有 Ankr Advanced API 端点
• NFT API：获取 NFT 元数据、持有者、转账记录和所有权信息
• Query API：访问区块链统计数据、区块、日志和交易数据
• Token API：获取代币余额、价格、持有者和转账历史记录
• 支持多个区块链网络

安装

# Clone the repository
git clone https://github.com/tumf/web3-mcp.git
cd web3-mcp

# Install with uv
uv pip install -e .

配置

设置以下环境变量：

# Required
export ANKR_ENDPOINT="your_ankr_rpc_endpoint"

# Optional but recommended for authenticated requests
export ANKR_PRIVATE_KEY="your_private_key"

使用方法

运行服务

from web3_mcp.server import init_server

# Initialize MCP server
mcp = init_server(
    name="Ankr MCP",
    endpoint="your_ankr_endpoint",  # Optional, defaults to ANKR_ENDPOINT env var
    private_key="your_private_key"  # Optional, defaults to ANKR_PRIVATE_KEY env var
)

# Run server
mcp.run()

配合 FastMCP CLI 使用

# Set environment variables first
export ANKR_ENDPOINT="your_ankr_endpoint"
export ANKR_PRIVATE_KEY="your_private_key"

# Run the server
python -m web3_mcp

API 类别

NFT API

• get_nfts_by_owner：获取钱包地址持有的 NFT
• get_nft_metadata：获取指定 NFT 的元数据
• get_nft_holders：获取指定 NFT 系列的持有者
• get_nft_transfers：获取 NFT 的转账历史记录

Query API

• get_blockchain_stats：获取区块链统计数据
• get_blocks：获取区块信息
• get_logs：获取区块链日志
• get_transactions_by_hash：按哈希值获取交易
• get_transactions_by_address：按地址获取交易
• get_interactions：获取钱包与合约的交互记录

Token API

• get_account_balance：获取钱包的代币余额
• get_currencies：获取可用货币
• get_token_price：获取代币价格信息
• get_token_holders：获取代币持有者
• get_token_holders_count：获取代币持有者数量
• get_token_transfers：获取代币转账历史记录

许可证

MIT