Shardeum MCP Server

Servidor MCP de Shardeum

Servidor del Protocolo de Contexto de Modelos para inspección de sistemas distribuidos y flujos de trabajo de desarrollo en Shardeum.

Este proyecto expone operaciones de red y RPC de Shardeum como herramientas MCP estructuradas para que agentes de IA, asistentes de IDE y flujos de trabajo de desarrollo puedan inspeccionar el estado de sistemas distribuidos mediante llamadas de herramientas validadas en lugar de scripts ad hoc. Está diseñado para depuración impulsada por agentes, inspección de nodos/red y operaciones de desarrollo repetibles.

Qué Demuestra

• Implementación de servidor MCP para uso de herramientas por agentes de IA
• Interfaces estructuradas de llamadas a herramientas sobre métodos RPC de sistemas distribuidos
• Inspección de nodos, ciclos, cuentas, bloques, transacciones y recibos
• Integración con IDE mediante Cursor y clientes compatibles con MCP
• Ruta de despliegue con Docker
• Manejo de errores alrededor de fallos de red y RPC
• Listado de servidores MCP revisado en seguridad mediante insignias de MseeP/Smithery

Arquitectura

MCP client / AI agent / Cursor
        |
        v
Shardeum MCP Server
        |
        +-- tool schema
        +-- request validation
        +-- RPC adapter
        +-- error handling
        |
        v
Shardeum RPC endpoint
        |
        v
Structured response to agent

Áreas de Herramientas Compatibles

Inspección de Red y Nodos

• shardeum_getNodeList
• shardeum_getNetworkAccount
• shardeum_getCycleInfo

Inspección de Bloques y Transacciones

• eth_blockNumber
• eth_getBlockByHash
• eth_getBlockByNumber
• eth_getBlockReceipts
• eth_getTransactionByHash
• eth_getTransactionReceipt
• eth_getTransactionCount

Consultas de Cuentas y Ejecución

• eth_getBalance
• eth_estimateGas
• eth_chainId

Integración con Cursor

Clona el repositorio, instala las dependencias y registra el servidor MCP:

npm install

Configuración MCP de Cursor:

{
  "mcpServers": {
    "shardeum-mcp": {
      "command": "node",
      "args": ["path_to/shardeum-mcp-server/index.js"]
    }
  }
}

Ejemplos de indicaciones:

What is the current Shardeum block number?
List available network nodes and summarize their state.
Fetch the receipt for this transaction and explain the result.
Inspect this account balance and transaction count.

Configuración

Establece el punto final RPC en la configuración del servidor o actualiza la constante rpcUrl para tu entorno objetivo.

Docker

docker build -t shardeum-mcp-server .
docker run --rm shardeum-mcp-server

Por Qué Esto No Es Trivial

Los servidores MCP brindan a los agentes acceso operativo a sistemas externos. Este proyecto convierte llamadas RPC de sistemas distribuidos en esquemas de herramientas explícitos, lo que facilita validar, depurar y restringir las acciones de los agentes en comparación con el acceso libre a shell o HTTP.

Hoja de Ruta

• Ampliar los métodos de red compatibles
• Agregar flujos de trabajo de transacciones seguros para escritura con puertas de confirmación explícitas
• Mejorar las respuestas tipadas y la validación
• Agregar diagnósticos más amplios de sistemas distribuidos
• Agregar más ejemplos de despliegue para clientes compatibles con MCP