Ethereum Tools for Claude

Un conjunto completo de herramientas para el análisis de la blockchain de Ethereum directamente dentro de Claude AI.

GitHub
19
Prueba este MCPPatrocinado

Documentación

Ethereum Tools for Claude MCP

Un kit de herramientas integral para el análisis de la blockchain de Ethereum directamente dentro de Claude AI utilizando el Protocolo de Contexto de Modelo (MCP).

Características

  • Auditoría de Contratos Inteligentes: Analiza contratos en busca de problemas de seguridad, verifica el código fuente y detecta estándares de tokens
  • Análisis de Carteras: Consulta saldos de ETH, tenencias de tokens e historial de transacciones
  • Seguimiento de Rentabilidad: Calcula ganancias/pérdidas de carteras en tokens y operaciones
  • Datos de Blockchain: Obtén y analiza datos on-chain con comandos simples
  • Análisis de Tokens: Obtén detalles completos de tokens, historial de precios y patrones de trading
  • Búsqueda en Twitter: Encuentra tweets por palabras clave, nombres de usuario, fechas o criterios de búsqueda complejos con procesamiento de lenguaje natural

Instalación

Requisitos previos

  • Node.js v16+
  • Claude for Desktop
  • Claves API gratuitas:
    • Etherscan - Para verificación y análisis de contratos
    • Moralis - Para rentabilidad de carteras y saldos de tokens
    • Codex - Para historial de precios de tokens y análisis avanzados
    • RapidAPI - Para la funcionalidad de búsqueda en Twitter
    • (Opcional) Proveedor RPC como Infura o usa endpoints públicos gratuitos

Pasos de configuración

  1. Clona este repositorio:

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

  2. Instala las dependencias:

    npm install

  3. Crea tu configuración:

    • Copia mcp.json.example a mcp.json
    • Edita mcp.json para incluir tus claves API y las rutas de archivo correctas
    {
  "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. Configura Claude for Desktop:

    • En Windows: Crea/edita %APPDATA%\Claude\claude_desktop_config.json
    • Copia el contenido de tu archivo mcp.json en esta configuración

Herramientas Disponibles

Análisis de Contratos

  • auditContract(address: "0x..."): Realiza una auditoría de seguridad en un contrato inteligente

Saldos y Tokens

  • getEthBalance(address: "0x..."): Obtén el saldo de ETH
  • getTransactionCount(address: "0x..."): Obtén el número de transacciones (nonce)
  • getTokensBalance(address: "0x...", chain: "eth", excludeSpam: true): Obtén todos los saldos de tokens

Rentabilidad

  • getWalletPnl(address: "0x...", chain: "eth"): Analiza ganancias/pérdidas de la cartera

Análisis de Tokens

  • getTokenInfo(address: "0x...", networkId: 1): Obtén información básica del token, incluyendo nombre, símbolo y suministro
  • getTokenPriceHistory(address: "0x...", networkId: 1, days: 7, resolution: "1D"): Obtén datos históricos de precios
  • analyzeToken(address: "0x...", networkId: 1, days: 30): Realiza un análisis completo del token, incluyendo volatilidad y patrones de trading

Búsqueda en Twitter

  • searchTwitter(query: "ethereum", section: "top", limit: 5): Búsqueda inteligente en Twitter con procesamiento de lenguaje natural

    • Formatea automáticamente consultas en lenguaje natural a la sintaxis correcta de Twitter
    • Comprende consultas de usuario como "Encuentra tweets de _gval sobre hyperliquid"
    • Soporta operadores avanzados de búsqueda en Twitter: from:username, has:links, etc.
    • Parámetros opcionales: min_likes, min_retweets, min_replies, start_date, end_date, language

  • twitterSearchHelp(topic: "general"): Obtén ayuda con la sintaxis de búsqueda en Twitter

    • Temas disponibles: "general", "user", "date"
    • Proporciona ejemplos y explicaciones de los operadores de búsqueda de Twitter

Utilidades

  • add(a: 1, b: 2): Ejemplo simple de función de utilidad

Solución de Problemas

Problemas comunes:

  • Variables de entorno no encontradas: Asegúrate de que tus claves API estén configuradas correctamente en mcp.json
  • Errores del proveedor: Verifica que tu ETH_RPC_URL sea válida y accesible
  • Errores de ruta: Asegúrate de usar rutas absolutas completas con el escape adecuado en Windows (\\)
  • Problemas con la API de Codex: Verifica que tu clave API de Codex sea válida y tenga permiso para acceder a los datos de tokens
  • Errores de búsqueda en Twitter: Asegúrate de que tu clave de RapidAPI tenga acceso a la API de Twitter154

Desarrollo

Para añadir nuevas herramientas:

  1. Crea o modifica archivos en el directorio tools/
  2. Registra tus herramientas en main.js
  3. Reinicia Claude for Desktop para ver los cambios

Licencia

Este proyecto está licenciado bajo la Licencia MIT.

Agradecimientos