Servidor MCP de Nodit

Un servidor de Model Context Protocol (MCP) que conecta agentes de IA y desarrolladores con datos de blockchain estructurados y listos para el contexto en múltiples redes a través de la infraestructura Web3 de Nodit.

Resumen

El Servidor MCP de Nodit simplifica la forma en que los modelos de IA y las aplicaciones interactúan con los ecosistemas blockchain.
En lugar de manejar RPC de nodos complejos, registros de eventos sin procesar o estructuras de datos específicas de cada cadena, los desarrolladores pueden acceder a datos de blockchain multicadena normalizados en un formato optimizado para el razonamiento y la toma de decisiones de IA.

Con el MCP de Nodit, puedes:

Crear agentes de IA que consulten, analicen y actúen sobre datos de blockchain en tiempo real en redes compatibles con EVM y no EVM.
Desarrollar aplicaciones integradas con Web3 sin requerir experiencia especializada en desarrollo blockchain.
Aprovechar la infraestructura de nodos confiable, las API de datos Web3 y los servicios de indexación GraphQL de Nodit a través de una capa de acceso unificada.
Desarrollar fácilmente con MCP de blockchain en integración local y remota, según las necesidades de tu flujo de trabajo.

Las redes compatibles incluyen Ethereum, Base, Optimism, Arbitrum, Polygon, Aptos, Bitcoin, Dogecoin, TRON, XRPL, GIWA(Sepolia) y más.

Lista de Herramientas

El Servidor MCP de Nodit proporciona herramientas que permiten a los agentes de IA descubrir, comprender e interactuar dinámicamente con las API Web3 y la infraestructura de datos de Nodit. Las herramientas minimizan el consumo de tokens y mantienen un contexto ligero al modularizar las interacciones con las API en pasos distintos:

Herramientas para Listar Categorías de API
Recupera una lista de categorías de API de alto nivel disponibles.
- list_nodit_api_categories
Herramientas para Listar Operaciones de API
Obtén las operaciones disponibles dentro de una categoría seleccionada (API de Nodos, API de Datos, API de Indexador de Aptos, API de Webhooks).
- list_nodit_node_apis
- list_nodit_data_apis
- list_nodit_aptos_indexer_api_query_root
- list_nodit_webhook_apis
Herramientas para Obtener Especificaciones de API
Obtén información detallada para una operación de API específica (parámetros, esquema de solicitud/respuesta).
- get_nodit_api_spec
- get_nodit_aptos_indexer_api_spec
Herramientas para Llamar a la API
Ejecuta una llamada a la API utilizando el operationId y los parámetros validados.
- call_nodit_api
- call_nodit_aptos_indexer_api

El Servidor MCP de Nodit se comunica utilizando el protocolo estándar JSON-RPC sobre stdio, siguiendo las convenciones del Model Context Protocol (MCP). Actualmente, solo se admite la comunicación basada en stdio para las interacciones servidor-cliente.

Características

Las siguientes son las características clave y las redes blockchain compatibles proporcionadas a través del Servidor MCP de Nodit para agentes de IA y LLMs.
Para especificaciones detalladas de API y pautas de uso, consulta la Documentación para Desarrolladores de Nodit.

API de Nodos RPC y Nodos
Accede a los endpoints de nodos blockchain a través de la infraestructura operada profesionalmente por Nodit.
Admite consultas de red en tiempo real, envío de transacciones, interacciones con contratos inteligentes y más.
API de Datos Web3
API de alto nivel para acceder a datos de blockchain meticulosamente indexados.
Incluye conjuntos de datos procesados como detalles de bloques y transacciones, historiales de transferencias de tokens, resúmenes de transacciones a nivel de cuenta y detalles de movimientos de activos — información que sería difícil de ensamblar directamente a través de llamadas RPC sin procesar.
API de Indexador GraphQL (solo Aptos)
Consulta actividades detalladas de la blockchain de Aptos a través de endpoints GraphQL.
Redes Compatibles
- Compatibles con EVM: Ethereum, Arbitrum, Avalanche, Base, Chiliz, Kaia, Optimism, Polygon, BNB Chain, GIWA(Sepolia)
- No EVM: Aptos, Bitcoin, Dogecoin, TRON, XRPL, Sui, Solana

Requisitos Previos

Node.js 18+
Clave de API de Nodit (Regístrate y obtén una clave de API en Consola de Nodit)

Ejecutar el Servidor MCP Local de Nodit

Usando npx (Recomendado)

npx @noditlabs/nodit-mcp-server@latest

Usando compilación local

# Clone the repository
git clone --recurse-submodules https://github.com/noditlabs/nodit-mcp-server.git

# Move into the project directory
cd nodit-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Antes de comenzar, configura tu clave de API de Nodit:

export NODIT_API_KEY=your-api-key

Luego inicia el servidor:

node build/index.js

Comunicación con el Servidor Local

Una vez que el Servidor MCP de Nodit esté ejecutándose localmente, puedes comunicarte con él usando JSON-RPC sobre stdio.
Así es como puedes enviar una solicitud básica al servidor:

Ejemplo: Listar herramientas disponibles

Puedes ingresar directamente el payload JSON-RPC:

{"method":"tools/list","params":{},"jsonrpc":"2.0","id":1}

O puedes canalizar la solicitud usando el comando echo:

echo '{"method":"tools/list","params":{},"jsonrpc":"2.0","id":1}' | node build/index.js

Ejemplo: Llamar a una herramienta específica (list_nodit_api_categories)

echo '{"method":"tools/call","params":{"name":"list_nodit_api_categories","arguments":{}},"jsonrpc":"2.0","id":1}' | node build/index.js

Conexión a Cursor IDE o Claude Desktop

Agrega la siguiente configuración a tu .cursor/mcp.json o claude_desktop_config.json:

Cursor
- MacOS: ~/.cursor/mcp.json
- Windows: C:\Users\<Username>\.cursor\mcp.json
Claude Desktop
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: C:\Users\<Username>\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nodit": {
      "command": "npx",
      "args": ["@noditlabs/nodit-mcp-server@latest"],
      "env": {
        "NODIT_API_KEY": "****"
      }
    }
  }
}

🔔 Importante
Reemplaza **** con tu clave de API real de Nodit.
Si la clave de API no está configurada correctamente, las solicitudes a la API fallarán debido a errores de autenticación.

Conexión a Claude CLI

También puedes usar el Servidor MCP de Nodit directamente con Claude CLI para una configuración rápida.

Agrega el Servidor MCP de Nodit con los siguientes comandos:

# Add the Nodit MCP server
claude mcp add nodit-mcp-server npx @noditlabs/nodit-mcp-server

# Set API Key
export NODIT_API_KEY=your-api-key

# Start Claude with the Nodit MCP server enabled
claude

Integrar el Servidor MCP Remoto de Nodit

Si estás usando una herramienta de IA que admite integración MCP remota, puedes conectarte al Servidor MCP Remoto de Nodit sin ejecutar un servidor MCP local. Esto te permite usar las funciones del MCP de Nodit directamente dentro de tu entorno de IA.

Endpoint

Usa el siguiente endpoint para conectarte al Servidor MCP Remoto de Nodit. Asegúrate de reemplazar INSERT_YOUR_API_KEY con tu clave de API real de Nodit.

https://mcp.nodit.io/sse?apiKey=INSERT_YOUR_API_KEY

Conexión a Claude (Web)

Si estás en el plan Claude Enterprise, Pro o Max, puedes integrar el Servidor MCP Remoto.

Ve a Configuración > Integraciones, haz clic en el botón [Agregar integración personalizada].
Haz clic en el botón [Agregar más] para integrar el nuevo MCP remoto.
Inserta el endpoint proporcionado anteriormente para completar la configuración.

Una vez completada la integración, verás que el MCP de Nodit se ha agregado en la sección Buscar y Herramientas en la pantalla principal de Claude.

Conexión a Cursor IDE

Para conectar el MCP de Nodit a Cursor IDE: 1. Abre Preferencias > Configuración de Cursor > Herramientas MCP. 2. Haz clic en [+ Nuevo Servidor MCP] para abrir el archivo de configuración mcp.json.

También puedes abrir y editar el archivo mcp.json directamente en la siguiente ruta:

MacOS: ~/.cursor/mcp.json
Windows: C:\Users\<Username>\.cursor\mcp.json

Agrega la siguiente configuración al objeto mcpServers. Si ya tienes otros servidores MCP configurados, separa cada entrada con una coma.

{
  "mcpServers": {
    "nodit": {
      "url": "https://mcp.nodit.io/sse?apiKey=INSERT_YOUR_API_KEY"
    }
  }
}

Una vez agregado, regresa a Herramientas MCP en la interfaz de Cursor y habilita el MCP de nodit activándolo. Cuando el estado muestre "9 herramientas habilitadas" en verde, la conexión estará completa.

Solución de Problemas

Problemas al ejecutar MCP vía npx en Claude Desktop

Si estás ejecutando el servidor MCP en combinación con Claude Desktop u otras herramientas que dependen de una instalación local de Node.js, puedes encontrar problemas debido a:

Múltiples versiones de Node.js instaladas (por ejemplo, a través de Homebrew y el instalador de paquetes)
Entornos PATH en conflicto
Claude Desktop no reconociendo el runtime correcto de Node.js

Sigue los pasos a continuación para verificar que Node.js 18+ esté instalado y reconocido correctamente en tu sistema.

1. Verifica tu versión actual de Node.js

Ejecuta el siguiente comando en tu terminal para verificar la versión:

node --version

Deberías ver un número de versión que comience con v18 o superior (por ejemplo, v18.19.0).

Si no es así, es posible que necesites instalar una versión compatible o cambiar a ella.

[!TIP] Claude Desktop puede no usar la misma versión de Node.js que tu terminal. Si tienes múltiples instalaciones (por ejemplo, a través de Homebrew, nvm o el instalador directo), puede usar una versión inesperada por defecto. Para listar todas las rutas de instalación comunes:
# Instalación de Homebrew
ls /usr/local/bin/node
ls /opt/homebrew/bin/node

# Instalaciones de nvm
ls ~/.nvm/versions/node/

# Instalación del sistema
ls /usr/bin/node

2. Instala o cambia a Node.js 18+ si es necesario

Si no tienes una versión compatible, instala Node.js usando uno de los siguientes métodos:

Usando el instalador oficial de Node.js: Descarga desde nodejs.org
Usando Homebrew (macOS):

bashbrew install node@20

Usando nvm (recomendado para la gestión de versiones):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20
nvm alias default 20

3. Verifica qué versión de Node.js usa Claude Desktop

Claude Desktop hereda el PATH de tu entorno del sistema. En tu terminal, ejecuta:

which node

Esto muestra la ruta del binario de Node.js actualmente activo en tu terminal. Esta es la ruta que Claude probablemente usará cuando se inicie desde esa terminal.

4. Fuerza a Claude Desktop a usar la versión correcta de Node.js

Si estás usando nvm:

nvm use 18  # Set proper version 
nvm alias default 18

Si estás usando Homebrew, asegúrate de que tenga prioridad en tu PATH:

export PATH="/opt/homebrew/bin:$PATH"  # for Apple Silicon
# or
export PATH="/usr/local/bin:$PATH"     # for Intel Macs

Recomendamos mantener un único método de instalación (por ejemplo, nvm o Homebrew) para evitar conflictos de versiones.

5. Reinicia Claude Desktop

Después de hacer cambios, reinicia Claude Desktop para asegurarte de que tome las variables de entorno y la versión de Node.js correctas.

Ejemplos de Prompts con el MCP de Nodit

Una vez que el MCP de Nodit esté conectado, puedes usar lenguaje natural para consultar directamente datos de blockchain de múltiples redes. Los ejemplos a continuación ilustran solo algunas de las muchas posibilidades — siéntete libre de ir más allá y explorar tus propios casos de uso.

📊 Monitoreo de Actividad On-chain

Summarize the recent activity of 0xabc…def across Ethereum and Arbitrum. Include major transactions, token transfers, and NFT interactions over the past 7 days.

What fungible and non-fungible tokens does this wallet hold across Ethereum and Polygon? Include balances and token names.

Analyze the risk profile of wallet 0xabc… based on its recent on-chain behavior.

🧾 Análisis de Contratos Inteligentes y Transacciones

Analyze how users interacted with the contract at 0xcontract… on Ethereum over the last week.

Analyze the last 10 blocks on Arbitrum.

🧠 Casos de Uso de Agentes de IA

Based on wallet 0xabc…’s holdings, recommend optimal DeFi strategies across Ethereum and Arbitrum.

Create a daily summary report for 0xdao… including token balances, inflow/outflow, and governance activity.

⚙️ Desarrollo de DApps Web3

Write TypeScript code using fetch to retrieve all ERC-20 transfers for 0xabc… from Ethereum using Nodit’s Node API.

Build a simple dashboard to visualize how assets have moved in recent XRPL transactions.

Build a dashboard that aggregates blockchain data across multiple chains using Nodit.

Alcance y Limitaciones

El Servidor MCP de Nodit proporciona contexto estructurado para ayudar a los agentes basados en LLM a utilizar las API de Nodit de manera efectiva.
Sus responsabilidades incluyen:

Estructurar las API de Nodit (API de Nodos, API de Datos Web3) en un formato consumible por LLM.
Exponer detalles de endpoints, esquemas de entrada/salida, respuestas de muestra y pautas de manejo de errores.

Sin embargo, lo siguiente está fuera del control del MCP:

La selección de API puede variar según la versión del LLM (por ejemplo, GPT-4, Claude 3), la ingeniería de prompts o el diseño del agente.
La interpretación de las respuestas o errores de la API depende de las capacidades de razonamiento del LLM consumidor.

El Servidor MCP de Nodit se enfoca en entregar contexto de API preciso y estructurado,
pero no garantiza los resultados finales de razonamiento o el comportamiento de LLMs externos.

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0.
Consulta el archivo LICENSE para conocer los términos completos de la licencia.
Los avisos legales relevantes se proporcionan en el archivo NOTICE.

"Nodit" y el logotipo de Nodit son marcas comerciales de Lambda256.
El uso del nombre o logotipo sin permiso previo por escrito está prohibido.

Nodit MCP Server

Documentación