Servidor MCP de Nodit

Un servidor de Protocolo de Contexto de Modelo (MCP) que conecta a los agentes y desarrolladores de IA con datos de blockchain estructurados y listos para el contexto en múltiples redes mediante la infraestructura Web3 de Nodit.

Descripción general

Nodit MCP Server simplifica la forma en que los modelos y aplicaciones de IA 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 la 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:

Cree agentes de IA que consulten, analicen y actúen sobre datos de blockchain en tiempo real en redes compatibles con EVM y no compatibles con EVM.
Cree aplicaciones integradas con Web3 sin necesidad de conocimientos especializados de desarrollo de blockchain.
Aproveche la confiable infraestructura de nodos de Nodit, las API de datos Web3 y los servicios de indexación GraphQL a través de una capa de acceso unificada.

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

Cómo funcionan las herramientas MCP de Nodit

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 de la API en pasos distintos:

Categorías de API de lista ( list_nodit_api_categories )
Recupere una lista de categorías de API de alto nivel disponibles.
Operaciones de API de lista ( list_nodit_node_apis , list_nodit_data_apis , list_nodit_aptos_indexer_api_query_root )
Obtener operaciones disponibles dentro de una categoría seleccionada (API de nodo, API de datos, API de indexador de Aptos).
Obtener la especificación de la API ( get_nodit_api_spec )
Obtener información detallada para una operación de API específica (parámetros, esquema de solicitud/respuesta).
Llamar a la API ( call_nodit_api , call_nodit_aptos_indexer_api )
Ejecute una llamada API utilizando el operationId y los parámetros validados.

El servidor MCP de Nodit se comunica mediante el protocolo estándar JSON-RPC sobre stdio, siguiendo las convenciones del Protocolo de Contexto de Modelo (MCP). Actualmente, solo se admite la comunicación basada en stdio para las interacciones entre el servidor y el cliente.

Características

Las siguientes son las características clave y las redes blockchain compatibles que ofrece Nodit MCP Server para agentes de IA y LLM.
Para conocer las especificaciones detalladas de la API y las pautas de uso, consulte la Documentación para desarrolladores de Nodit .

Nodo RPC y API de nodo
Acceda a los puntos finales de los nodos blockchain a través de la infraestructura operada profesionalmente por Nodit.
Admite consultas de red en tiempo real, envíos de transacciones, interacciones de 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 movimiento de activos: información que sería difícil de reunir directamente a través de llamadas RPC sin procesar.
API de indexación de GraphQL (solo Aptos)
Consulta actividades detalladas de la cadena de bloques de Aptos a través de puntos finales GraphQL.
Redes compatibles
- Compatible con EVM: Ethereum, Arbitrum, Avalanche, Base, Kaia, Optimism, Polygon
- No EVM: Aptos, Bitcoin, Dogecoin, TRON, XRPL

Prerrequisitos

Node.js 18+
Clave API de Nodit (Regístrese y obtenga una clave API en la consola de Nodit )

Ejecución del servidor local Nodit MCP

Uso de 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, configure su clave API de Nodit:

export NODIT_API_KEY=your-api-key

Luego inicia el servidor:

node build/index.js

Comunicarse con el servidor local

Una vez que el servidor Nodit MCP se ejecuta localmente, puede comunicarse con él usando JSON-RPC a través de stdio .
A continuación te explicamos cómo puedes enviar una solicitud básica al servidor:

Ejemplo: Lista de herramientas disponibles

Puede ingresar directamente la carga útil JSON-RPC:

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

O bien, puede canalizar la solicitud mediante 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

Integración

Conexión a Cursor IDE o Claude Desktop

Agregue la siguiente configuración a su .cursor/mcp.json o claude_desktop_config.json :

Cursor
- MacOS: ~/.cursor/mcp.json
- Windows: C:\Users\<Username>\.cursor\mcp.json
Escritorio de Claude
- 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": "****"
      }
    }
  }
}

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

Conexión a Claude CLI

También puede utilizar Nodit MCP Server directamente con Claude CLI para una configuración rápida.

Agregue Nodit MCP Server 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

Alcance y limitaciones

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

Estructuración de las API de Nodit (API de Node, API de datos Web3) en un formato consumible por LLM.
Exponer detalles de puntos finales, esquemas de entrada/salida, respuestas de muestra y pautas de manejo de errores.

Sin embargo, lo siguiente queda fuera del control del MCP :

La selección de API puede variar según la versión de LLM (por ejemplo, GPT-4, Claude 3), la ingeniería rápida 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.

Nodit MCP Server se centra en ofrecer un contexto de API preciso y estructurado,
pero no garantiza los resultados finales del razonamiento o el comportamiento de los LLM externos.

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0 .
Consulte el archivo LICENCIA para conocer los términos completos de la licencia.
Los avisos legales pertinentes se proporcionan en el archivo AVISO .

"Nodit" y el logotipo de Nodit son marcas comerciales de Lambda256.
Se prohíbe el uso del nombre o logotipo sin autorización previa por escrito.

Nodit MCP Server

Integrations