Servidor MCP de la API de Ankr

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

Descripción general

El servidor MCP de Ankr obtiene datos en cadena 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.

Related MCP server: Base Network MCP Server

Características

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

Operaciones de tokens

• Obtener saldos de tokens (get_token_balances): Obtiene todos los saldos de tokens de una billetera en una blockchain específica

• Obtener monedas (get_currencies): Enumera todas las monedas disponibles en una blockchain

• Obtener precio de token (get_token_price): Obtiene el precio actual en USD de cualquier token

• Obtener titulares de tokens (get_token_holders): Enumera las direcciones de los titulares de un token

• Obtener recuento de titulares de tokens (get_token_holders_count): Obtiene datos históricos del recuento de titulares

• Obtener transferencias de tokens (get_token_transfers): Obtiene el historial de transferencias de tokens para direcciones

• Obtener historial de precios de tokens (get_token_price_history): Obtiene datos históricos de precios a lo largo del tiempo

• Explicar precio de token (explain_token_price): Desglosa cómo se deriva el precio de un token

Operaciones de NFT

• Obtener NFT por propietario (get_nfts_by_owner): Obtiene todos los NFT propiedad de una billetera

• Obtener metadatos de NFT (get_nft_metadata): Obtiene metadatos (nombre, imagen, rasgos) para un NFT específico

• Obtener titulares de NFT (get_nft_holders): Obtiene todos los titulares de una colección de NFT

• Obtener transferencias de NFT (get_nft_transfers): Obtiene el historial de transferencias de NFT

Operaciones de consulta

• Obtener estadísticas de blockchain (get_blockchain_stats): Obtiene estadísticas de la cadena (transacciones, tiempo de bloque, etc.)

• Obtener bloques (get_blocks): Obtiene datos completos de bloques para un rango de bloques

• Obtener registros (get_logs): Obtiene datos históricos de registros de eventos

• Obtener transacciones por hash (get_transactions_by_hash): Busca una transacción por hash

• Obtener transacciones por dirección (get_transactions_by_address): Obtiene todas las transacciones de una dirección

• Obtener interacciones (get_interactions): Enumera todas las cadenas con las que ha interactuado una billetera

• Obtener saldo de cuenta histórico (get_account_balance_historical): Obtiene el saldo en una altura de bloque pasada

• Obtener transacciones internas por bloque (get_internal_transactions_by_block): Obtiene transacciones internas en un bloque

• Obtener transacciones internas por hash principal (get_internal_transactions_by_parent_hash): Obtiene transacciones internas de una transacción principal

Instalación

npm install @akki91/ankr-mcp

Uso

Configuración del entorno

Establezca su 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), lo que permite que se utilice como proveedor de herramientas para modelos de IA compatibles.

Integración con modelos de IA

Para integrar este servidor con aplicaciones de IA que admitan MCP, agregue lo siguiente a la configuración del servidor de su aplicación:

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

Integración de herramientas MCP de Ankr en Claude Desktop

Siga las instrucciones a continuación para actualizar su configuración y asegurarse de que su servidor MCP esté disponible dentro de Claude Desktop.

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

1. Inicie Claude Desktop.

2. Desde el menú principal, navegue a Settings (Configuración).

Paso 2: Actualizar la configuración de desarrollador

1. Abra la Developer Settings (Configuración de desarrollador).

2. Edite el archivo de configuración que contiene las definiciones de su servidor MCP.

3. Si ya hay servidores MCP enumerados, agregue su configuración de MCP de Ankr a la lista existente. De lo contrario, copie y pegue toda la configuración anterior para el servidor MCP de Ankr.

Paso 3: Reiniciar Claude Desktop

1. Cierre el menú de Developer Settings.

2. Reinicie Claude Desktop para aplicar los cambios.

Paso 4: Verificar la integración

1. Una vez que Claude Desktop se haya reiniciado, haga clic en el icono de herramientas ubicado justo debajo del mensaje de chat.

2. Verifique que la lista de herramientas proporcionadas por el servidor MCP de Ankr sea visible y accesible.

Al seguir estos pasos, su configuración de MCP de Ankr debería estar integrada en Claude Desktop, lo que le permitirá acceder a sus herramientas directamente a través de la interfaz.

Ejemplos de mensajes de chat

Aquí hay ejemplos de mensajes que puede 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

Construcció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 para este proyecto es compatible mediante MCP Inspector

npm run debug

Fuentes

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

Verificación