Shardeum MCP Server

Shardeum MCP Server

Servidor Model Context Protocol para inspeção de sistemas distribuídos e fluxos de trabalho de desenvolvimento na Shardeum.

Este projeto expõe operações de rede e RPC da Shardeum como ferramentas MCP estruturadas, permitindo que agentes de IA, assistentes de IDE e fluxos de trabalho de desenvolvimento inspecionem o estado de sistemas distribuídos por meio de chamadas de ferramentas validadas, em vez de scripts ad hoc. Ele foi projetado para depuração orientada por agentes, inspeção de nós/redes e operações de desenvolvimento repetíveis.

O Que Ele Demonstra

• Implementação de servidor MCP para uso de ferramentas por agentes de IA
• Interfaces estruturadas de chamadas de ferramentas sobre métodos RPC de sistemas distribuídos
• Inspeção de nós, ciclos, contas, blocos, transações e recibos
• Integração com IDE via Cursor e clientes compatíveis com MCP
• Caminho de implantação com Docker
• Tratamento de erros em falhas de rede e RPC
• Listagem de servidor MCP revisada por segurança por meio de selos MseeP/Smithery

Arquitetura

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 Ferramentas Suportadas

Inspeção de Rede e Nós

• shardeum_getNodeList
• shardeum_getNetworkAccount
• shardeum_getCycleInfo

Inspeção de Blocos e Transações

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

Consultas de Contas e Execução

• eth_getBalance
• eth_estimateGas
• eth_chainId

Integração com Cursor

Clone o repositório, instale as dependências e registre o servidor MCP:

npm install

Configuração MCP do Cursor:

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

Exemplos de prompts:

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.

Configuração

Defina o endpoint RPC na configuração do servidor ou atualize a constante rpcUrl para o seu ambiente de destino.

Docker

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

Por Que Isso Não É Trivial

Servidores MCP dão aos agentes acesso operacional a sistemas externos. Este projeto converte chamadas RPC de sistemas distribuídos em esquemas de ferramentas explícitos, tornando as ações dos agentes mais fáceis de validar, depurar e restringir em comparação com acesso livre a shell ou HTTP.

Roteiro

• Expandir métodos de rede suportados
• Adicionar fluxos de trabalho de transações seguros para escrita com portões de confirmação explícitos
• Melhorar respostas tipadas e validação
• Adicionar diagnósticos mais amplos de sistemas distribuídos
• Adicionar mais exemplos de implantação para clientes compatíveis com MCP