Veri5ight

Um servidor MCP que permite interação baseada em chat com nós Ethereum.

GitHub
1
Experimente este MCPPatrocinado

Documentação

🔍 Veri5ight

Seu simpático sussurrador de nós Ethereum! Um servidor Model Context Protocol (MCP) que ajuda o Claude a conversar com nós Ethereum.

🌟 Sobre o que é isso?

Veri5ight é uma interface direta entre o Claude e nós Ethereum, fornecendo:

  • 💰 Informações em tempo real de saldo de tokens e delegação para qualquer ERC20
  • 🔎 Informações de contratos inteligentes
  • 🚀 Acesso direto ao nó sem limites de taxa
  • 🔒 Interações privadas e seguras

Veri5ight Server MCP server

🚀 Início Rápido

# Clone the repository
git clone https://github.com/5ajaki/veri5ight.git

# Install dependencies
npm install

# Build the project
npm run build

⚙️ Configuração

  1. Copie .env.example para .env:
cp .env.example .env
  1. Adicione a URL do seu nó Ethereum (exemplo abaixo - atualize com a URL e porta reais do seu nó):
ETH_NODE_URL="http://localhost:8545"  # Example - replace with your node's URL and port
  1. Configure o Claude Desktop:
{
  "mcpServers": {
    "veri5ight": {
      "command": "node",
      "args": ["/absolute/path/to/veri5ight/dist/index.js"] // Local path to the compiled index.js file
    }
  }
}

Nota: O caminho no passo 3 deve apontar para o index.js compilado no seu diretório dist local. Isso é criado quando você executa npm run build.

Opções de Inicialização

Por padrão, o Veri5ight inicia automaticamente com o Claude Desktop App. Se preferir executá-lo sob demanda:

  1. Remova o script postbuild do package.json que inicia automaticamente com o Claude
  2. Execute manualmente quando necessário:
node dist/index.js

🎮 Ferramentas Disponíveis

ethereum_getTokenBalance

Obtenha o saldo de tokens para qualquer token ERC20 usando endereço ou nome ENS.

Exemplo:

Claude, what's vitalik.eth's UNI balance?

ethereum_getTokenDelegation

Verifique informações de delegação para qualquer token de governança.

Exemplo:

Claude, who has nick.eth delegated their tokens to?

ethereum_getContractInfo

Obtenha informações detalhadas sobre qualquer contrato inteligente.

Exemplo:

Claude, what can you tell me about this contract: nick.eth

ethereum_getRecentTransactions

Visualize transações recentes para qualquer endereço. Nota: Esta função verifica os 10 blocos mais recentes em busca de transações envolvendo o endereço especificado.

Exemplo:

Claude, show me any recent transactions for vitalik.eth

A função retornará até o número solicitado de transações (padrão 3) encontradas nesses blocos. Se nenhuma transação for encontrada nos blocos recentes, ela retornará um resultado vazio.

🔍 Depuração

Verifique os logs do Claude para qualquer problema:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

💡 Por que Acesso Direto ao Nó?

  • Baixa Latência: Consultas diretas ao nó sem sobrecarga de API
  • Sem Limites de Taxa: Consultas ilimitadas ao seu próprio nó
  • Privacidade: As consultas ficam entre você e seu nó
  • Acesso Total: Disponibilidade completa da API JSON-RPC
  • Dados em Tempo Real: Acesso direto ao estado mais recente da blockchain

🛠️ Desenvolvimento

# Watch mode for the cool kids
npm run dev

# Build for production
npm run build

🤝 Contribuindo

Tem ideias? Encontrou um bug? PRs são bem-vindos! Basta:

  1. Fazer um fork
  2. Criar uma branch
  3. Codar
  4. Enviar o PR

📜 Licença

MIT - Pode mandar ver! Veja LICENSE para os detalhes jurídicos chatos.

🙏 Agradecimentos

  • Feito com ❤️ pela equipe Veri5ight
  • Alimentado pelo cérebro gigante do Claude
  • Apoiado nos ombros dos gigantes do Ethereum

🆘 Precisa de Ajuda?

  • 🐛 Encontrou um bug? Abra uma issue!
  • 🤔 Perguntas? Inicie uma discussão!
  • 🎉 Ideia de recurso legal? Queremos ouvir!

Lembre-se: Veri5ight é como um canivete suíço para dados Ethereum - só não tente abrir garrafas com ele! 🍾