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 等。