Ankr API MCP Server

Ankr API MCP 服务

通过 Ankr API 获取区块链数据的 MCP（Model Context Protocol）服务。

概览

Ankr MCP 服务通过 Ankr API 获取链上数据。它实现了 MCP，使大模型能够查询 20 多条链上的区块链数据。

功能

该服务提供 21 个工具，涵盖所有 Ankr Advanced API 类别：

代币操作

• 获取代币余额（get_token_balances）：获取特定区块链上某个钱包的所有代币余额
• 获取货币（get_currencies）：列出某条区块链上所有可用的货币
• 获取代币价格（get_token_price）：获取任意代币当前的美元价格
• 获取代币持有者（get_token_holders）：列出某个代币的持有者地址
• 获取代币持有者数量（get_token_holders_count）：获取历史持有者数量数据
• 获取代币转账记录（get_token_transfers）：获取地址的代币转账历史
• 获取代币价格历史（get_token_price_history）：获取一段时间内的历史价格数据
• 解释代币价格（explain_token_price）：分析代币价格的计算方式

NFT 操作

• 按所有者获取 NFT（get_nfts_by_owner）：获取某个钱包拥有的所有 NFT
• 获取 NFT 元数据（get_nft_metadata）：获取特定 NFT 的元数据（名称、图片、特征）
• 获取 NFT 持有者（get_nft_holders）：获取某个 NFT 系列的所有持有者
• 获取 NFT 转账记录（get_nft_transfers）：获取 NFT 转账历史

查询操作

• 获取区块链统计信息（get_blockchain_stats）：获取链上统计信息（交易数、区块时间等）
• 获取区块（get_blocks）：获取指定区块范围的完整区块数据
• 获取日志（get_logs）：获取历史事件日志数据
• 按哈希获取交易（get_transactions_by_hash）：按哈希查询交易
• 按地址获取交易（get_transactions_by_address）：获取某个地址的所有交易
• 获取交互记录（get_interactions）：列出某个钱包交互过的所有链
• 获取历史账户余额（get_account_balance_historical）：获取过去某个区块高度的余额
• 按区块获取内部交易（get_internal_transactions_by_block）：获取某个区块中的内部交易
• 按父哈希获取内部交易（get_internal_transactions_by_parent_hash）：获取来自某笔父交易的内部交易

安装

npm install @akki91/ankr-mcp

使用方法

环境设置

登录 ANKR API 文档门户，设置 ANKR API 令牌。

export ANKR_API_TOKEN=your_api_token_here

运行服务

可以直接从命令行运行服务：

npx @akki91/ankr-mcp

与大模型工具配合使用

该服务实现了 Model Context Protocol（MCP），可作为兼容 AI 模型的工具提供方。

与 AI 模型集成

要将此服务集成到支持 MCP 的 AI 应用中，请将以下内容添加到应用的服务配置中：

{
  "mcpServers": {
    "ankr-mcp": {
      "command": "npx",
      "args": [
        "@akki91/ankr-mcp"
      ],
      "env": {
        "ANKR_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

在 Claude Desktop 中集成 Ankr MCP 工具

按照以下说明更新设置，确保 Claude Desktop 中可以使用 MCP 服务。

第 1 步：访问 Claude Desktop 设置

1. 启动 Claude Desktop。
2. 从主菜单中进入 设置。

第 2 步：更新开发者设置

1. 打开 开发者设置。
2. 编辑包含 MCP 服务定义的配置文件。
3. 如果已列出 MCP 服务，请将 Ankr MCP 配置追加到现有列表中；否则，复制并粘贴上文中 Ankr MCP 服务的完整配置。

第 3 步：重启 Claude Desktop

1. 关闭 开发者设置菜单。
2. 重启 Claude Desktop以应用更改。

步骤 4：验证集成

1. Claude Desktop 重启后，点击聊天提示词下方的 工具图标。
2. 确认可以看到并访问 Ankr MCP 服务提供的工具列表。

按照这些步骤操作后，Ankr MCP 配置现在应该已集成到 Claude Desktop 中，你可以直接通过界面访问其工具。

示例聊天提示词

以下是一些示例提示词，你可以在 Claude 或任何兼容的 AI 中与此 MCP 服务配合使用：

代币查询

What are the token balances for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum?

What's the current price of USDC on Ethereum?

Show me the price history of ETH over the last 30 days.

How many holders does the LINK token have on Ethereum?

Show me recent token transfers for vitalik.eth on Polygon.

NFT 查询

What NFTs does 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 own?

Get me the metadata for Bored Ape #1234.

Who holds NFTs from the CryptoPunks collection?

Show me recent NFT transfers for this wallet on Ethereum.

区块链与交易查询

What are the current stats for Ethereum and Polygon?

Which blockchains has wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 interacted with?

Look up transaction 0x1234abcd... and decode the logs.

Show me the latest blocks on Arbitrum with transactions included.

What were the internal transactions in Ethereum block 19000000?

What was my wallet balance at block 17000000?

开发

从源代码构建

# Clone the repository
git clone https://github.com/akki91/ankr-mcp.git
cd ankr-mcp

# Install dependencies
npm install

# Build the project
npm run build

运行测试

npm test

调试模式

此项目支持使用 MCP Inspector 进行调试。

npm run debug

来源

此项目的灵感来自此处创建的服务列表。

验证