Servidor Etherscan de MCP

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona herramientas de datos de la cadena de bloques de Ethereum a través de la API de Etherscan. Sus funciones incluyen la consulta de saldos de ETH, la visualización del historial de transacciones, el seguimiento de transferencias ERC20, la obtención de ABI de contratos, la monitorización de precios del gas y la resolución de nombres ENS.

Características

• Consulta de saldo : obtén el saldo de ETH de cualquier dirección de Ethereum

• Historial de transacciones : vea transacciones recientes con información detallada

• Transferencias de tokens : seguimiento de transferencias de tokens ERC20 con detalles del token

• ABI de contrato : obtenga ABI de contratos inteligentes para el desarrollo

• Precios de la gasolina : Monitorea los precios actuales de la gasolina (Bajo Seguro, Estándar, Rápido)

• Resolución ENS : resuelve direcciones de Ethereum en nombres ENS

Related MCP server: MCP Etherscan Server

Prerrequisitos

• Node.js >= 18

• Una clave API de Etherscan (obtenga una en https://etherscan.io/apis )

Instalación

1. Clonar el repositorio:

git clone [your-repo-url]
cd mcp-etherscan-server

2. Instalar dependencias:

npm install

3. Cree un archivo .env en el directorio raíz:

ETHERSCAN_API_KEY=your_api_key_here

4. Construir el proyecto:

npm run build

Ejecución del servidor

Iniciar el servidor:

npm start

El servidor se ejecutará en stdio, lo que lo hace compatible con clientes MCP como Claude Desktop.

Cómo funciona

Este servidor implementa el Protocolo de Contexto de Modelo (MCP) para proporcionar herramientas que permitan interactuar con los datos de la cadena de bloques de Ethereum a través de la API de Etherscan. Cada herramienta se expone como un endpoint MCP al que pueden acceder clientes compatibles.

Herramientas disponibles

1. check-balance

   • Entrada: dirección de Ethereum

   • Salida: Saldo de ETH tanto en Wei como en ETH

2. get-transactions

   • Entrada: dirección de Ethereum, límite opcional

   • Salida: Transacciones recientes con marcas de tiempo, valores y direcciones

3. get-token-transfers

   • Entrada: dirección de Ethereum, límite opcional

   • Salida: Transferencias recientes de tokens ERC20 con detalles del token

4. get-contract-abi

   • Entrada: Dirección del contrato

   • Salida: ABI del contrato en formato JSON

5. get-gas-prices

   • Entrada: Ninguna

   • Salida: Precios actuales del gas en Gwei

6. get-ens-name

   • Entrada: dirección de Ethereum

   • Salida: Nombre de ENS asociado si está disponible

Uso con Claude Desktop

Para agregar este servidor a Claude Desktop:

1. Inicie el servidor usando npm start

2. En Claude Desktop:

   • Ir a Configuración

   • Vaya a la sección Servidores MCP

   • Haga clic en "Agregar servidor"

   • Introduzca la siguiente configuración:

     {
       "name": "Etherscan Tools",
       "transport": "stdio",
       "command": "node /path/to/mcp-etherscan-server/build/index.js"
     }

   • Guardar la configuración

3. Las herramientas de Etherscan ahora estarán disponibles en tus conversaciones de Claude

Ejemplo de uso en Claude

Puedes utilizar comandos como:

Check the balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

o

Show me recent transactions for vitalik.eth

Desarrollo

Para agregar nuevas funciones o modificar las existentes:

1. La lógica principal del servidor está en src/server.ts

2. Las interacciones de la API de Etherscan se gestionan en src/services/etherscanService.ts

3. Construir después de los cambios: npm run build

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles