Ankr API MCP Server

Ankr API MCP Server

Servidor MCP (Model Context Protocol) para datos de blockchain a través de la API de Ankr.

Descripción general

El servidor Ankr MCP obtiene datos on-chain a través de la API de Ankr. Implementa el MCP para permitir que los LLM consulten datos de blockchain en más de 20 cadenas.

Características

El servidor proporciona 21 herramientas en todas las categorías de la API avanzada de Ankr:

Operaciones de tokens

• Get Token Balances (get_token_balances): Obtiene todos los saldos de tokens de una billetera en una blockchain específica
• Get Currencies (get_currencies): Enumera todas las monedas disponibles en una blockchain
• Get Token Price (get_token_price): Obtiene el precio actual en USD de cualquier token
• Get Token Holders (get_token_holders): Enumera las direcciones de tenedores de un token
• Get Token Holders Count (get_token_holders_count): Obtiene datos históricos del número de tenedores
• Get Token Transfers (get_token_transfers): Obtiene el historial de transferencias de tokens para direcciones
• Get Token Price History (get_token_price_history): Obtiene datos históricos de precios a lo largo del tiempo
• Explain Token Price (explain_token_price): Desglosa cómo se deriva el precio de un token

Operaciones de NFT

• Get NFTs by Owner (get_nfts_by_owner): Obtiene todos los NFT propiedad de una billetera
• Get NFT Metadata (get_nft_metadata): Obtiene metadatos (nombre, imagen, rasgos) de un NFT específico
• Get NFT Holders (get_nft_holders): Obtiene todos los tenedores de una colección de NFT
• Get NFT Transfers (get_nft_transfers): Obtiene el historial de transferencias de NFT

Operaciones de consulta

• Get Blockchain Stats (get_blockchain_stats): Obtiene estadísticas de la cadena (transacciones, tiempo de bloque, etc.)
• Get Blocks (get_blocks): Obtiene datos completos de bloques para un rango de bloques
• Get Logs (get_logs): Obtiene datos históricos de registros de eventos
• Get Transactions by Hash (get_transactions_by_hash): Busca una transacción por hash
• Get Transactions by Address (get_transactions_by_address): Obtiene todas las transacciones de una dirección
• Get Interactions (get_interactions): Enumera todas las cadenas con las que una billetera ha interactuado
• Get Account Balance Historical (get_account_balance_historical): Obtiene el saldo en una altura de bloque pasada
• Get Internal Transactions by Block (get_internal_transactions_by_block): Obtiene transacciones internas en un bloque
• Get Internal Transactions by Parent Hash (get_internal_transactions_by_parent_hash): Obtiene transacciones internas de una transacción padre

Instalación

npm install @akki91/ankr-mcp

Uso

Configuración del entorno

Establece tu token de API de ANKR iniciando sesión en el portal de documentación de la API de ANKR.

export ANKR_API_TOKEN=your_api_token_here

Ejecución del servidor

El servidor se puede ejecutar directamente desde la línea de comandos:

npx @akki91/ankr-mcp

Uso con herramientas LLM

Este servidor implementa el Protocolo de Contexto de Modelo (MCP), que le permite ser utilizado como proveedor de herramientas para modelos de IA compatibles.

Integración con modelos de IA

Para integrar este servidor con aplicaciones de IA que admiten MCP, agrega lo siguiente a la configuración del servidor de tu aplicación:

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

Integración de herramientas Ankr MCP en Claude Desktop

Sigue las instrucciones a continuación para actualizar tu configuración y asegurarte de que tu servidor MCP esté disponible en Claude Desktop.

Paso 1: Accede a la configuración en Claude Desktop

1. Inicia Claude Desktop.
2. Desde el menú principal, navega a Configuración.

Paso 2: Actualiza la configuración de desarrollador

1. Abre la Configuración de desarrollador.
2. Edita el archivo de configuración que contiene las definiciones de tu servidor MCP.
3. Si ya hay servidores MCP listados, agrega tu configuración de Ankr MCP a la lista existente. De lo contrario, copia y pega toda la configuración anterior para el servidor Ankr MCP.

Paso 3: Reinicia Claude Desktop

1. Cierra el menú de Configuración de desarrollador.
2. Reinicia Claude Desktop para aplicar los cambios.

Paso 4: Verifica la integración

1. Una vez que Claude Desktop se haya reiniciado, haz clic en el Icono de herramientas ubicado justo debajo del campo de chat.
2. Verifica que la lista de herramientas proporcionadas por el servidor Ankr MCP sea visible y accesible.

Siguiendo estos pasos, tu configuración de Ankr MCP debería estar integrada en Claude Desktop, lo que te permite acceder a sus herramientas directamente a través de la interfaz.

Ejemplos de mensajes de chat

Aquí hay ejemplos de mensajes que puedes usar con este servidor MCP en Claude o cualquier IA compatible:

Consultas de tokens

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 y transacciones

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?

Desarrollo

Compilación desde el código fuente

# 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

Ejecución de pruebas

npm test

Modo de depuración

La depuración de este proyecto es compatible con MCP Inspector

npm run debug

Fuentes

Este proyecto está inspirado en la lista de servidores creada aquí

Verificación