使用说明

项目简介

aapi-mcp-server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它利用 Ankr 高级 API 为大型语言模型 (LLM) 提供访问区块链数据的能力。通过此 MCP 服务器，LLM 可以安全、便捷地获取链上信息，从而扩展其在区块链应用场景中的功能。

主要功能点

账户余额查询 (getAccountBalance)：
- 查询指定区块链地址或 ENS 名称的账户余额。
- 支持查询多个区块链的余额，默认查询所有支持链。
代币价格查询 (getTokenPrice)：
- 获取指定区块链上代币的当前价格。
- 支持查询原生代币和 ERC20 代币的价格。
广泛的区块链支持：
- 支持包括 Ethereum, BSC, Polygon, Arbitrum, Avalanche 等主流主网，以及 Sepolia, Holesky, Fuji 等测试网。
多种部署方式：
- 支持本地开发、远程服务器部署和 Asphere 托管版本。
兼容 MCP 客户端：
- 可以与任何支持 MCP 协议的客户端连接，例如 Cursor 编辑器和 Claude 桌面应用。

安装步骤

安装 Node.js 和 npm/pnpm：确保你的开发环境已安装 Node.js 和包管理器 npm 或 pnpm。
获取 Ankr API Key：访问 ankr.com/rpc 注册并创建一个免费账户，获取你的 Ankr API Key。
安装依赖：克隆仓库代码到本地后，在项目根目录下运行 'pnpm install' 或 'npm install' 安装项目依赖。

服务器配置

1. Cursor 编辑器配置

在 Cursor 编辑器中配置 MCP 服务器，以便 LLM 可以调用 aapi-mcp-server 提供的工具。

服务器名称 (Name): 自定义服务器名称，例如 "Ankr AAPI MCP Server"。
服务器类型 (Type): 选择 "command"。
启动命令 (Command): 配置服务器启动命令，需要替换 '<YOUR_KEY>' 为你实际的 Ankr API Key。

{
    "server name": "Ankr AAPI MCP Server",
    "type": "command",
    "command": "env ANKR_API_KEY=<YOUR_KEY> npx -y @asphere/aapi-mcp-server"
}

参数说明：

'env ANKR_API_KEY=<YOUR_KEY>': 设置环境变量 'ANKR_API_KEY'，用于传递你的 Ankr API Key。请务必替换 '<YOUR_KEY>' 为你实际的 API Key。
'npx -y @asphere/aapi-mcp-server': 使用 'npx' 执行 '@asphere/aapi-mcp-server' 包，'-y' 参数表示自动确认安装包。

2. Claude 桌面应用配置

在 Claude 桌面应用中，你需要在配置文件中添加 MCP 服务器信息。

打开 Claude 的配置文件（通常是 JSON 格式），在 'mcpServers' 字段下添加 aapi-mcp-server 的配置。

{
  "mcpServers": {
    "aapi": {  //  "aapi" 是你自定义的服务器标识符，可以在 Claude 中引用
      "command": "npx",
      "args": ["-y", "@asphere/aapi-mcp-server"],
      "env": {
        "ANKR_API_KEY": "<YOUR_KEY>" //  请务必替换 <YOUR_KEY> 为你实际的 API Key
      }
    }
  }
}

参数说明：

'"aapi"': 服务器的标识符，在 Claude 中使用 '@aapi:工具名称' 的方式调用工具。
'"command": "npx"': 指定启动命令为 'npx'。
'"args": ["-y", "@asphere/aapi-mcp-server"]': 传递给 'npx' 的参数，'-y' 自动安装 '@asphere/aapi-mcp-server' 包。
'"env": { "ANKR_API_KEY": "<YOUR_KEY>" }': 设置环境变量 'ANKR_API_KEY'，请替换 '<YOUR_KEY>' 为你的 API Key。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端（如 Cursor 或 Claude）中，你可以通过以下方式调用 aapi-mcp-server 提供的工具：

调用 'getAccountBalance' 工具：

例如，在 LLM 的对话中，你可以指示模型使用 'getAccountBalance' 工具查询某个以太坊地址的余额。
工具名称：'getAccountBalance'

参数示例：

{
  "address": "0xYourEthereumAddress",
  "blockchains": ["eth", "bsc"] // 可选，指定查询的区块链，不指定则查询所有支持链
}

调用 'getTokenPrice' 工具：

指示模型使用 'getTokenPrice' 工具查询代币价格。
工具名称：'getTokenPrice'