Nodit MCP Server

Fornece dados de blockchain estruturados e prontos para contexto em múltiplas redes através da infraestrutura Web3 da Nodit.

GitHub
23
Experimente este MCPPatrocinado

Documentação

Nodit MCP Server

Um servidor Model Context Protocol (MCP) que conecta agentes de IA e desenvolvedores a dados de blockchain estruturados e prontos para contexto em múltiplas redes através da infraestrutura Web3 da Nodit.

Nodit Server MCP server

License Node.js TypeScript smithery badge

Visão Geral

O Nodit MCP Server simplifica a forma como modelos de IA e aplicações interagem com ecossistemas de blockchain.
Em vez de lidar com RPCs de nós complexos, logs de eventos brutos ou estruturas de dados específicas de cada chain, os desenvolvedores podem acessar dados de blockchain normalizados e multi-chain em um formato otimizado para raciocínio e tomada de decisão de IA.

Com o MCP da Nodit, você pode:

  • Criar agentes de IA que consultam, analisam e agem sobre dados de blockchain em tempo real em redes compatíveis com EVM e não-EVM.
  • Desenvolver aplicações integradas à Web3 sem exigir conhecimento especializado em desenvolvimento de blockchain.
  • Aproveitar a infraestrutura confiável de nós, as Web3 Data APIs e os serviços de indexação GraphQL da Nodit através de uma camada de acesso unificada.
  • Desenvolver facilmente com blockchain MCP em integração local e remota, dependendo das necessidades do seu fluxo de trabalho.

As redes suportadas incluem Ethereum, Base, Optimism, Arbitrum, Polygon, Aptos, Bitcoin, Dogecoin, TRON, XRPL, GIWA(Sepolia) e outras.

Sumário

Lista de Ferramentas

O Nodit MCP Server fornece ferramentas que permitem que agentes de IA descubram, entendam e interajam dinamicamente com as Web3 APIs e a infraestrutura de dados da Nodit. As ferramentas minimizam o consumo de tokens e mantêm um contexto leve ao modularizar as interações com a API em etapas distintas:

  • Ferramentas para Listar Categorias de API
    Recupera uma lista das categorias de API de alto nível disponíveis.

    • list_nodit_api_categories

  • Ferramentas para Listar Operações de API
    Busca operações disponíveis dentro de uma categoria selecionada (Node APIs, Data APIs, Aptos Indexer APIs, Webhook APIs).

    • list_nodit_node_apis
    • list_nodit_data_apis
    • list_nodit_aptos_indexer_api_query_root
    • list_nodit_webhook_apis

  • Ferramentas para Obter Especificação de API
    Obtém informações detalhadas para uma operação de API específica (parâmetros, esquema de requisição/resposta).

    • get_nodit_api_spec
    • get_nodit_aptos_indexer_api_spec

  • Ferramentas para Chamar API
    Executa uma chamada de API usando o operationId e parâmetros validados.

    • call_nodit_api
    • call_nodit_aptos_indexer_api

O Nodit MCP Server se comunica usando o protocolo padrão JSON-RPC sobre stdio, seguindo as convenções do Model Context Protocol (MCP). Atualmente, apenas a comunicação baseada em stdio é suportada para interações servidor-cliente.

Recursos

A seguir estão os principais recursos e redes de blockchain suportadas fornecidas através do Nodit MCP Server para agentes de IA e LLMs.
Para especificações detalhadas de API e diretrizes de uso, consulte a Documentação para Desenvolvedores da Nodit.

  • RPC Node & Node APIs
    Acesse endpoints de nós de blockchain através da infraestrutura operada profissionalmente pela Nodit.
    Suporta consultas de rede em tempo real, envio de transações, interações com smart contracts e muito mais.

  • Web3 Data APIs
    APIs de alto nível para acessar dados de blockchain meticulosamente indexados.
    Inclui conjuntos de dados processados, como detalhes de blocos e transações, históricos de transferência de tokens, resumos de transações em nível de conta e detalhes de movimentação de ativos — informações que seriam difíceis de montar diretamente através de chamadas RPC brutas.

  • GraphQL Indexer APIs (somente Aptos)
    Consulte atividades detalhadas do blockchain Aptos através de endpoints GraphQL.

  • Redes Suportadas

    • Compatíveis com EVM: Ethereum, Arbitrum, Avalanche, Base, Chiliz, Kaia, Optimism, Polygon, BNB Chain, GIWA(Sepolia)
    • Não-EVM: Aptos, Bitcoin, Dogecoin, TRON, XRPL, Sui, Solana

Pré-requisitos

  • Node.js 18+
  • Chave de API da Nodit (Cadastre-se e obtenha uma chave de API no Nodit Console)

Executando o Nodit MCP Server Local

Usando npx (Recomendado)

npx @noditlabs/nodit-mcp-server@latest

Usando build 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 começar, defina sua chave de API da Nodit:

export NODIT_API_KEY=your-api-key

Em seguida, inicie o servidor:

node build/index.js

Comunicando-se com o Servidor Local

Quando o Nodit MCP Server estiver em execução localmente, você pode se comunicar com ele usando JSON-RPC sobre stdio.
Veja como você pode enviar uma requisição básica ao servidor:

Exemplo: Listar ferramentas disponíveis

Você pode inserir diretamente o payload JSON-RPC:

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

Ou você pode canalizar a requisição usando o comando echo:

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

Exemplo: Chamar uma ferramenta 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

Conectando ao Cursor IDE ou Claude Desktop

Adicione a seguinte configuração ao seu .cursor/mcp.json ou 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
Substitua **** pela sua chave de API real da Nodit.
Se a chave de API não estiver configurada corretamente, as requisições de API falharão devido a erros de autenticação.

Conectando ao Claude CLI

Você também pode usar o Nodit MCP Server diretamente com o Claude CLI para uma configuração rápida.

Adicione o Nodit MCP Server com os seguintes 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

Integrando o Nodit Remote MCP Server

Se você estiver usando uma ferramenta de IA que suporta integração Remote MCP, você pode se conectar ao Remote MCP Server da Nodit sem executar um servidor MCP local. Isso permite que você use os recursos do Nodit MCP diretamente no seu ambiente de IA.

Endpoint

Use o seguinte endpoint para se conectar ao Nodit Remote MCP Server. Certifique-se de substituir INSERT_YOUR_API_KEY pela sua chave de API real da Nodit.

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

Conectando ao Claude (Web)

Se você estiver no plano Claude Enterprise, Pro ou Max, você pode integrar o Remote MCP Server.

  1. Vá para Settings > Integrations, clique no botão [Add custom integration].
  2. Clique no botão [Add more] para integrar o novo Remote MCP.
  3. Insira o endpoint fornecido acima para concluir a configuração.

Quando a integração for concluída, você verá que o Nodit MCP foi adicionado na seção Search and Tools na tela principal do Claude.

Conectando ao Cursor IDE

Para conectar o Nodit MCP ao Cursor IDE: 1. Abra Preferences > Cursor Settings > MCP Tools. 2. Clique em [+ New MCP Server] para abrir o arquivo de configuração mcp.json.

Você também pode abrir e editar o arquivo mcp.json diretamente no seguinte caminho:

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

Adicione a seguinte configuração ao objeto mcpServers. Se você já tiver outros servidores MCP configurados, separe cada entrada com uma vírgula.

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

Depois de adicionado, volte para MCP Tools na interface do Cursor e ative o nodit MCP alternando-o. Quando o status mostrar "9 tools enabled" em verde, a conexão estará completa.

Solução de Problemas

Problemas ao executar MCP via npx no Claude Desktop

Se você estiver executando o servidor MCP em combinação com Claude Desktop ou outras ferramentas que dependem de uma instalação local do Node.js, você pode encontrar problemas devido a:

  • Múltiplas versões do Node.js instaladas (por exemplo, via Homebrew e instalador de pacotes)
  • Ambientes PATH conflitantes
  • Claude Desktop não reconhecendo o runtime correto do Node.js

Siga os passos abaixo para verificar se o Node.js 18+ está instalado e reconhecido corretamente no seu sistema.

1. Verifique sua versão ativa atual do Node.js

Execute o seguinte comando no seu terminal para verificar a versão:

node --version

Você deve ver um número de versão começando com v18 ou superior (por exemplo, v18.19.0).

Se não, você pode precisar instalar uma versão compatível ou alternar para ela.

[!TIP] O Claude Desktop pode não usar a mesma versão do Node.js que o seu terminal. Se você tiver múltiplas instalações (por exemplo, via Homebrew, nvm ou instalador direto), ele pode usar uma versão inesperada por padrão. Para listar todos os caminhos de instalação comuns:

# Instalação via Homebrew
ls /usr/local/bin/node
ls /opt/homebrew/bin/node

# Instalações via nvm
ls ~/.nvm/versions/node/

# Instalação do sistema
ls /usr/bin/node

2. Instale ou alterne para Node.js 18+ se necessário

Se você não tiver uma versão compatível, instale o Node.js usando um dos seguintes métodos:

  • Usando o instalador oficial do Node.js: Baixe de nodejs.org
  • Usando Homebrew (macOS):
bashbrew install node@20
  • Usando nvm (recomendado para gerenciamento de versões):
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. Verifique qual versão do Node.js o Claude Desktop usa

O Claude Desktop herda o PATH do ambiente do seu sistema. No seu terminal, execute:

which node

Isso exibe o caminho do binário do Node.js atualmente ativo no seu terminal. Este é o caminho que o Claude provavelmente usará quando iniciado a partir desse terminal.

4. Force o Claude Desktop a usar a versão correta do Node.js

  • Se você estiver usando nvm:
nvm use 18  # Set proper version 
nvm alias default 18
  • Se você estiver usando Homebrew, certifique-se de que ele tenha prioridade no seu PATH:
export PATH="/opt/homebrew/bin:$PATH"  # for Apple Silicon
# or
export PATH="/usr/local/bin:$PATH"     # for Intel Macs

Recomendamos manter um único método de instalação (por exemplo, nvm ou Homebrew) para evitar conflitos de versão.

5. Reinicie o Claude Desktop

Após fazer alterações, reinicie o Claude Desktop para garantir que ele capture as variáveis de ambiente e a versão correta do Node.js.

Exemplos de Prompts com Nodit MCP

Quando o Nodit MCP estiver conectado, você pode usar linguagem natural para consultar diretamente dados de blockchain de múltiplas redes. Os exemplos abaixo ilustram apenas algumas das muitas possibilidades — sinta-se à vontade para ir além deles e explorar seus próprios casos de uso.

📊 Monitoramento de Atividade 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álise de Smart Contracts e Transações

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.

⚙️ Desenvolvimento 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.

Escopo e Limitações

O Nodit MCP Server fornece contexto estruturado para ajudar agentes baseados em LLM a utilizar as APIs da Nodit de forma eficaz.
Suas responsabilidades incluem:

  • Estruturar as APIs da Nodit (Node APIs, Web3 Data APIs) em um formato consumível por LLM.
  • Expor detalhes de endpoints, esquemas de entrada/saída, respostas de exemplo e diretrizes de tratamento de erros.

No entanto, os seguintes itens estão fora do controle do MCP:

  • A seleção de API pode variar dependendo da versão do LLM (por exemplo, GPT-4, Claude 3), engenharia de prompts ou design do agente.
  • A interpretação de respostas ou erros de API depende das capacidades de raciocínio do LLM consumidor.

O Nodit MCP Server foca em entregar contexto de API preciso e estruturado,
mas não garante os resultados finais de raciocínio ou o comportamento de LLMs externos.

Licença

Este projeto é licenciado sob a Apache License 2.0.
Consulte o arquivo LICENSE para os termos completos da licença.
Avisos legais relevantes são fornecidos no arquivo NOTICE.

"Nodit" e o logotipo da Nodit são marcas registradas da Lambda256.
O uso do nome ou logotipo sem permissão prévia por escrito é proibido.

© Lambda256. Todos os direitos reservados.