Ethereum Tools for Claude

Um kit de ferramentas abrangente para análise da blockchain Ethereum diretamente no Claude AI.

GitHub
19
Experimente este MCPPatrocinado

Documentação

Ethereum Tools for Claude MCP

Um kit de ferramentas abrangente para análise de blockchain Ethereum diretamente no Claude AI usando o Model Context Protocol (MCP).

Recursos

  • Auditoria de Smart Contracts: Analise contratos em busca de problemas de segurança, verifique o código-fonte e detecte padrões de tokens
  • Análise de Carteiras: Verifique saldos de ETH, participações em tokens e histórico de transações
  • Acompanhamento de Rentabilidade: Calcule lucro/perda de carteiras em tokens e negociações
  • Dados de Blockchain: Busque e analise dados on-chain com comandos simples
  • Análise de Tokens: Obtenha detalhes abrangentes de tokens, histórico de preços e padrões de negociação
  • Busca no Twitter: Encontre tweets por palavras-chave, nomes de usuário, datas ou critérios de busca complexos com processamento de linguagem natural

Instalação

Pré-requisitos

  • Node.js v16+
  • Claude for Desktop
  • Chaves de API gratuitas:
    • Etherscan - Para verificação e análise de contratos
    • Moralis - Para rentabilidade de carteiras e saldos de tokens
    • Codex - Para histórico de preços de tokens e análises avançadas
    • RapidAPI - Para funcionalidade de busca no Twitter
    • (Opcional) Provedor RPC como Infura ou use endpoints públicos gratuitos

Etapas de Configuração

  1. Clone este repositório:

    git clone https://github.com/0xGval/evm-tools-mcp
cd evm-tools-mcp

  2. Instale as dependências:

    npm install

  3. Crie sua configuração:

    • Copie mcp.json.example para mcp.json
    • Edite mcp.json para incluir suas chaves de API e caminhos de arquivo corretos
    {
  "mcpServers": {
    "ethereum-tools": {
      "command": "node",
      "args": ["YOUR_ABSOLUTE_PATH_TO/main.js"],
      "env": {
        "ETH_RPC_URL": "https://eth.llamarpc.com",
        "MORALIS_API_KEY": "your_moralis_api_key",
        "ETHERSCAN_API_KEY": "your_etherscan_api_key",
        "CODEX_API_KEY": "your_codex_api_key",
        "RAPIDAPI_KEY": "your_rapidapi_key"
      }
    }
  }
}

  4. Configure o Claude for Desktop:

    • No Windows: Crie/edite %APPDATA%\Claude\claude_desktop_config.json
    • Copie o conteúdo do seu arquivo mcp.json para esta configuração

Ferramentas Disponíveis

Análise de Contratos

  • auditContract(address: "0x..."): Realize auditoria de segurança em um smart contract

Saldo e Tokens

  • getEthBalance(address: "0x..."): Obtenha saldo de ETH
  • getTransactionCount(address: "0x..."): Obtenha contagem de transações (nonce)
  • getTokensBalance(address: "0x...", chain: "eth", excludeSpam: true): Obtenha todos os saldos de tokens

Rentabilidade

  • getWalletPnl(address: "0x...", chain: "eth"): Analise lucro/perda de carteira

Análise de Tokens

  • getTokenInfo(address: "0x...", networkId: 1): Obtenha informações básicas do token, incluindo nome, símbolo e fornecimento
  • getTokenPriceHistory(address: "0x...", networkId: 1, days: 7, resolution: "1D"): Obtenha dados históricos de preços
  • analyzeToken(address: "0x...", networkId: 1, days: 30): Realize análise abrangente de tokens, incluindo volatilidade e padrões de negociação

Busca no Twitter

  • searchTwitter(query: "ethereum", section: "top", limit: 5): Busca inteligente no Twitter com processamento de linguagem natural

    • Formata automaticamente consultas em linguagem natural para a sintaxe adequada do Twitter
    • Entende consultas de usuários como "Encontre tweets de _gval sobre hyperliquid"
    • Suporta operadores avançados de busca do Twitter: from:username, has:links, etc.
    • Parâmetros opcionais: min_likes, min_retweets, min_replies, start_date, end_date, language

  • twitterSearchHelp(topic: "general"): Obtenha ajuda com a sintaxe de busca do Twitter

    • Tópicos disponíveis: "general", "user", "date"
    • Fornece exemplos e explicações dos operadores de busca do Twitter

Utilitários

  • add(a: 1, b: 2): Exemplo simples de função utilitária

Solução de Problemas

Problemas comuns:

  • Variáveis de ambiente não encontradas: Certifique-se de que suas chaves de API estejam configuradas corretamente em mcp.json
  • Erros do provedor: Verifique se seu ETH_RPC_URL é válido e acessível
  • Erros de caminho: Certifique-se de usar caminhos absolutos completos com escape adequado no Windows (\\)
  • Problemas com a API Codex: Verifique se sua chave de API Codex é válida e tem permissão para acessar dados de tokens
  • Erros de busca no Twitter: Certifique-se de que sua chave RapidAPI tenha acesso à API Twitter154

Desenvolvimento

Para adicionar novas ferramentas:

  1. Crie ou modifique arquivos no diretório tools/
  2. Registre suas ferramentas em main.js
  3. Reinicie o Claude for Desktop para ver as alterações

Licença

Este projeto está licenciado sob a Licença MIT.

Agradecimentos