ethereum-tools

Herramientas de Ethereum para Claude MCP

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

Características

• Auditoría de contratos inteligentes : analice los contratos para detectar problemas de seguridad, verifique el código fuente y detecte estándares de tokens
• Análisis de billetera : verifique saldos de ETH, tenencias de tokens e historial de transacciones
• Seguimiento de rentabilidad : Calcule las ganancias/pérdidas de la billetera en todos los tokens y transacciones
• Datos de blockchain : obtenga y analice datos en cadena con comandos simples
• Análisis de tokens : obtenga detalles completos de los tokens, historial de precios y patrones comerciales

Instalación

Prerrequisitos

• Node.js v16+
• Claude para escritorio
• Claves API gratuitas:
  • Etherscan : para verificación y análisis de contratos
  • Moralis - Para la rentabilidad de la billetera y los saldos de tokens
  • Codex : para el historial de precios de tokens y análisis avanzados
  • (Opcional) Proveedor de RPC como Infura o utilice puntos finales públicos gratuitos

Pasos de configuración

1. Clonar este repositorio:
   git clone https://github.com/giovannialbero1992/ethereum-tools-mcp cd ethereum-tools-mcp
2. Instalar dependencias:
   npm install
3. Crea tu configuración:
   • Copiar mcp.json.example a mcp.json
   • Edite mcp.json para incluir sus claves API y 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" } } } }
4. Configurar Claude para escritorio:
   • En Windows: crear/editar %APPDATA%\Claude\claude_desktop_config.json
   • Copie el contenido de su archivo mcp.json en esta configuración

Herramientas disponibles

Análisis de contratos

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

Saldo y tokens

• getEthBalance(address: "0x...") : Obtener el saldo de ETH
• getTransactionCount(address: "0x...") : Obtener el recuento de transacciones (nonce)
• getTokensBalance(address: "0x...", chain: "eth", excludeSpam: true) : Obtener todos los saldos de tokens

Rentabilidad

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

Análisis de tokens

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

Servicios públicos

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

Solución de problemas

Problemas comunes:

• Variables de entorno no encontradas : asegúrese de que sus claves API estén configuradas correctamente en mcp.json
• Errores del proveedor : Verifique que su ETH_RPC_URL sea válida y accesible
• Errores de ruta : asegúrese de utilizar rutas absolutas completas con el escape adecuado en Windows ( \\ )
• Problemas con la API de Codex : Verifique que su clave de API de Codex sea válida y tenga permiso para acceder a los datos del token

Desarrollo

Para agregar nuevas herramientas:

1. Crear o modificar archivos en el directorio tools/
2. Registra tus herramientas en main.js
3. Reinicie Claude for Desktop para ver los cambios

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Expresiones de gratitud

• Protocolo de Contexto Modelo (MCP) de Anthropic
• Web3.js
• Moralis
• Etherscan
• Códice