aapi-mcp-server

🚀 Ankr 高级 API MCP 服务器 ⚡

这是一个基于 Model Context Protocol (MCP) 的服务器，它提供了与 Ankr 高级 API 进行交互的工具。借助该服务器，AI 模型能够获取区块链数据并执行各类操作。

🚀 快速开始

本服务器可助力 AI 模型获取区块链数据并执行操作，下面为您详细介绍其使用方法。

✨ 主要特性

• 丰富的工具：提供 getAccountBalance 和 getTokenPrice 等工具，方便获取代币余额和价格。
• 多链支持：支持众多主网和测试网区块链，满足不同场景需求。
• 灵活配置：可在 Cursor、Claude Desktop 等环境中配置使用，也支持本地开发和远程部署。

📦 安装指南

前提条件

1. 您需要拥有 Ankr API Key，可在 ankr.com/rpc 创建免费账户获取。

配置 Cursor 🖥️

1. 打开 Cursor 设置。
2. 转到功能 > MCP 服务器。
3. 点击 "+ 添加新的 MCP 服务器" 按钮。
4. 填写以下信息：
   • 名称：输入服务器的昵称（例如，"Ankr AAPI MCP"）。
   • 类型：选择 "命令" 类型。
   • 命令：env ANKR_API_KEY=<YOUR_KEY> npx -y @asphere/aapi-mcp-server。

与 Claude Desktop 使用

{
  "mcpServers": {
    "aapi": {
      "command": "npx",
      "args": ["-y", "@asphere/aapi-mcp-server"],
      "env": {
        "ANKR_API_KEY": "<YOUR_KEY>"
      }
    }
  }
}

本地开发

安装依赖项：

pnpm i

运行本地 SSE 服务器：

export ANKR_API_KEY="YOUR-ANKR-KEY"
pnpm dev:sse

远程服务器

在远程模式下，服务为每个连接创建一个隔离的 MCP 服务器实例，通过互联网实现安全和隔离的访问。每个连接需要 URL 路径中的 apiKey 进行 Ankr 高级 API 的身份验证。

Asphere 管理的 AAPI MCP 远程服务器

管理版本在 https://aapi-mcp-server.asphere.network/ 上可用：

https://aapi-mcp-server.asphere.network/{ANKR-API-KEY}/sse

本地开发

# 启动远程服务器
pnpm dev:remote

# 使用 localhost 连接
http://localhost:3001/{apiKey}/sse

部署

部署后，MCP 客户端可以使用以下方式连接：

type: sse
url: https://your-remote-url.com/{apiKey}/sse

💻 使用示例

基础用法

以下是使用工具的示例：

getAccountBalance

# 获取任何地址或 ENS 名称在多个链上的代币余额
# 参数:
#   address: Ethereum 地址 (0x...) 或 ENS 名称 (*.eth)
#   blockchains (可选): 要查询的特定区块链数组。如果不提供，则检查所有支持的链

getTokenPrice

# 获取任何代币（原生或 ERC20）在支持链上的当前价格
# 参数:
#   blockchain: 区块链网络 (eth, bsc, polygon, 等等)
#   contractAddress (可选): 代币的合同地址。留空以获取原生代币

📚 详细文档

工具详情

• getAccountBalance：用于获取任何地址或 ENS 名称在多个链上的代币余额。
  • 参数：
    • address：Ethereum 地址（0x...）或 ENS 名称（*.eth）。
    • blockchains（可选）：要查询的特定区块链数组。若不提供，则检查所有支持的链。
• getTokenPrice：用于获取任何代币（原生或 ERC20）在支持链上的当前价格。
  • 参数：
    • blockchain：区块链网络（eth, bsc, polygon 等）。
    • contractAddress（可选）：代币的合同地址。留空以获取原生代币。

支持的区块链

• 主网：Ethereum、BSC、Polygon、Arbitrum、Avalanche、Base、Fantom、Gnosis、Linea、Optimism 等。
• 测试网：Ethereum Sepolia、Ethereum Holesky、Base Sepolia、Avalanche Fuji 等。