MCP-сервер Ankr API

MCP-сервер (Model Context Protocol) для работы с данными блокчейна через API Ankr.

Обзор

MCP-сервер Ankr получает данные из блокчейна через API Ankr. Он реализует протокол MCP, позволяя LLM запрашивать данные блокчейна в более чем 20 сетях.

Related MCP server: Base Network MCP Server

Функции

Сервер предоставляет 21 инструмент по всем категориям Ankr Advanced API:

Операции с токенами

• Получить балансы токенов (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

Использование

Настройка окружения

Установите свой токен API ANKR, войдя на портал документации API ANKR.

export ANKR_API_TOKEN=your_api_token_here

Запуск сервера

Сервер можно запустить напрямую из командной строки:

npx @akki91/ankr-mcp

Использование с инструментами LLM

Этот сервер реализует протокол Model Context Protocol (MCP), что позволяет использовать его в качестве поставщика инструментов для совместимых моделей ИИ.

Интеграция с моделями ИИ

Чтобы интегрировать этот сервер с приложениями ИИ, поддерживающими MCP, добавьте следующее в конфигурацию сервера вашего приложения:

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

Интеграция инструментов Ankr MCP в Claude Desktop

Следуйте приведенным ниже инструкциям, чтобы обновить настройки и убедиться, что ваш MCP-сервер доступен в Claude Desktop.

Шаг 1: Доступ к настройкам в Claude Desktop

1. Запустите Claude Desktop.

2. В главном меню перейдите в Settings (Настройки).

Шаг 2: Обновление настроек разработчика

1. Откройте Developer Settings (Настройки разработчика).

2. Отредактируйте файл конфигурации, содержащий определения ваших MCP-серверов.

3. Если MCP-серверы уже указаны, добавьте конфигурацию Ankr MCP в существующий список. В противном случае скопируйте и вставьте всю конфигурацию выше для сервера Ankr MCP.

Шаг 3: Перезапуск Claude Desktop

1. Закройте меню Developer Settings.

2. Перезапустите Claude Desktop, чтобы применить изменения.

Шаг 4: Проверка интеграции

1. После перезапуска Claude Desktop нажмите на значок инструментов (Tools Icon), расположенный прямо под полем ввода чата.

2. Убедитесь, что список инструментов, предоставляемых сервером Ankr MCP, виден и доступен.

Выполнив эти шаги, вы интегрируете конфигурацию Ankr MCP в Claude Desktop, что позволит вам получать доступ к его инструментам непосредственно через интерфейс.

Примеры запросов для чата

Вот примеры запросов, которые вы можете использовать с этим MCP-сервером в Claude или любой совместимой модели ИИ:

Запросы по токенам

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

Источники

Этот проект вдохновлен списком серверов, созданных здесь

Верификация