Ankr API MCP Server

Ankr API MCP Server

Servidor MCP (Model Context Protocol) para dados de blockchain através da API Ankr.

Visão Geral

O Servidor MCP da Ankr busca dados on-chain via API da Ankr. Ele implementa o MCP para permitir que LLMs consultem dados de blockchain em mais de 20 cadeias.

Recursos

O servidor fornece 21 ferramentas em todas as categorias da API Avançada da Ankr:

Operações de Token

• Get Token Balances (get_token_balances): Obtém todos os saldos de token para uma carteira em uma blockchain específica
• Get Currencies (get_currencies): Lista todas as moedas disponíveis em uma blockchain
• Get Token Price (get_token_price): Obtém o preço atual em USD para qualquer token
• Get Token Holders (get_token_holders): Lista endereços de detentores de um token
• Get Token Holders Count (get_token_holders_count): Obtém dados históricos de contagem de detentores
• Get Token Transfers (get_token_transfers): Obtém histórico de transferências de token para endereços
• Get Token Price History (get_token_price_history): Obtém dados históricos de preço ao longo do tempo
• Explain Token Price (explain_token_price): Explica como o preço de um token é derivado

Operações de NFT

• Get NFTs by Owner (get_nfts_by_owner): Obtém todos os NFTs pertencentes a uma carteira
• Get NFT Metadata (get_nft_metadata): Obtém metadados (nome, imagem, atributos) para um NFT específico
• Get NFT Holders (get_nft_holders): Obtém todos os detentores de uma coleção de NFT
• Get NFT Transfers (get_nft_transfers): Obtém histórico de transferências de NFT

Operações de Consulta

• Get Blockchain Stats (get_blockchain_stats): Obtém estatísticas da cadeia (transações, tempo de bloco, etc.)
• Get Blocks (get_blocks): Obtém dados completos de bloco para um intervalo de blocos
• Get Logs (get_logs): Obtém dados históricos de logs de eventos
• Get Transactions by Hash (get_transactions_by_hash): Busca uma transação pelo hash
• Get Transactions by Address (get_transactions_by_address): Obtém todas as transações de um endereço
• Get Interactions (get_interactions): Lista todas as cadeias com as quais uma carteira interagiu
• Get Account Balance Historical (get_account_balance_historical): Obtém saldo em uma altura de bloco passada
• Get Internal Transactions by Block (get_internal_transactions_by_block): Obtém transações internas em um bloco
• Get Internal Transactions by Parent Hash (get_internal_transactions_by_parent_hash): Obtém transações internas de uma transação pai

Instalação

npm install @akki91/ankr-mcp

Uso

Configuração do Ambiente

Defina seu token da API ANKR fazendo login no portal de documentação da API ANKR.

export ANKR_API_TOKEN=your_api_token_here

Executando o Servidor

O servidor pode ser executado diretamente da linha de comando:

npx @akki91/ankr-mcp

Uso com Ferramentas de LLM

Este servidor implementa o Model Context Protocol (MCP), que permite que ele seja usado como provedor de ferramentas para modelos de IA compatíveis.

Integração com Modelos de IA

Para integrar este servidor com aplicações de IA que suportam MCP, adicione o seguinte à configuração do servidor do seu aplicativo:

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

Integrando Ferramentas MCP da Ankr no Claude Desktop

Siga as instruções abaixo para atualizar suas configurações e garantir que seu servidor MCP esteja disponível no Claude Desktop.

Passo 1: Acessar Configurações no Claude Desktop

1. Inicie o Claude Desktop.
2. No menu principal, navegue até Configurações.

Passo 2: Atualizar Configurações do Desenvolvedor

1. Abra as Configurações do Desenvolvedor.
2. Edite o arquivo de configuração que contém as definições do seu servidor MCP.
3. Se os servidores MCP já estiverem listados, adicione sua configuração MCP da Ankr à lista existente. Caso contrário, copie e cole toda a configuração acima para o servidor MCP da Ankr.

Passo 3: Reiniciar o Claude Desktop

1. Feche o menu Configurações do Desenvolvedor.
2. Reinicie o Claude Desktop para aplicar as alterações.

Passo 4: Verificar Integração

1. Após o Claude Desktop reiniciar, clique no Ícone de Ferramentas localizado logo abaixo do prompt de chat.
2. Verifique se a lista de ferramentas fornecida pelo servidor MCP da Ankr está visível e acessível.

Seguindo esses passos, sua configuração MCP da Ankr deve agora estar integrada ao Claude Desktop, permitindo que você acesse suas ferramentas diretamente pela interface.

Exemplos de Prompts de Chat

Aqui estão exemplos de prompts que você pode usar com este servidor MCP no Claude ou em qualquer IA compatível:

Consultas de Token

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.

Consultas de 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.

Consultas de Blockchain e Transações

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?

Desenvolvimento

Compilando a partir do Código Fonte

# 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

Executando Testes

npm test

Modo de Depuração

A depuração deste projeto é suportada usando o MCP Inspector

npm run debug

Fontes

Este projeto é inspirado na lista de servidores criada aqui

Verificação