Ankr API MCP Server

Ankr API MCP サーバー

Ankr API を通じてブロックチェーンデータを取得する MCP（Model Context Protocol）サーバーです。

概要

Ankr MCP サーバーは Ankr API を介してオンチェーンデータを取得します。MCP を実装しており、LLM が 20 以上のチェーンにまたがるブロックチェーンデータをクエリできます。

機能

このサーバーは、Ankr Advanced API のすべてのカテゴリーにわたって 21 個のツールを提供します。

トークン操作

• トークン残高の取得（get_token_balances）：特定のブロックチェーン上で、ウォレットのすべてのトークン残高を取得します
• 通貨の取得（get_currencies）：ブロックチェーンで利用可能なすべての通貨を一覧表示します
• トークン価格の取得（get_token_price）：任意のトークンの現在の USD 価格を取得します
• トークン保有者の取得（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

LLM ツールでの使用

このサーバーは 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 に統合され、インターフェースから直接そのツールにアクセスできるようになります。

チャットプロンプトの例

以下は、この MCP サーバーを Claude または互換性のある AI で使用する際のプロンプト例です。

トークンに関する問い合わせ

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

参考元

このプロジェクトは、こちらで作成されたサーバーの一覧に着想を得ています。

検証