blockscout-mcp-server

Un servidor MCP stdio de solo lectura que ofrece a los agentes de IA datos on-chain multicadena de EVM — direcciones, transacciones, bloques, logs, tokens, NFTs y código fuente de contratos — a través de la API REST de Blockscout.

[!IMPORTANT] Este no es el servidor MCP oficial de Blockscout. Es un servidor personalizado, construido de forma independiente y mantenido por un desarrollador individual; no está afiliado ni respaldado por el equipo de Blockscout.

Inicio rápido

npx descarga el paquete publicado y lo ejecuta: no hay que instalar nada manualmente. Funciona desde cualquier proyecto; apunta CHAINS_FILE al archivo de cadenas de ese proyecto (un ./chains.json relativo se resuelve contra el directorio de trabajo del cliente).

{
  "mcpServers": {
    "blockscout": {
      "command": "npx",
      "args": ["-y", "blockscout-mcp-server"],
      "env": {
        "CHAINS_FILE": "./chains.json",
        "ONLY_CHAINS_FILE": "true"
      }
    }
  }
}

El registro de cadenas y las variables de entorno se leen una sola vez al iniciar. Si cambias la configuración o el código, reinicia (reconecta) el servidor en tu cliente MCP. Se incluye un .mcp.example.json listo para editar.

Related MCP server: Onesource MCP

Cadenas compatibles

Estas cadenas se registran de serie desde la instantánea incluida (src/chains/bundled.json), sin necesidad de configuración. El argumento chain de cualquier herramienta acepta tanto el nombre (ethereum) como el ID numérico de la cadena (1).

Llama a la herramienta get_chains_list para ver las cadenas realmente registradas en un servidor en ejecución.

Cadenas personalizadas

Apunta CHAINS_FILE a un archivo JSON que describa cadenas adicionales (o que sobrescriba las ya incluidas). Cada entrada necesita un name, un chainId y la url de la instancia de Blockscout:

[
  { "name": "my-l2", "chainId": 42, "url": "https://scan.my-l2.io" }
]

Si CHAINS_FILE está definido, pero el archivo no existe o tiene un formato no válido, el servidor se cierra inmediatamente (fail-fast).

Define ONLY_CHAINS_FILE=true para registrar solo las cadenas de CHAINS_FILE y excluir por completo la instantánea incluida. Requiere que CHAINS_FILE esté definido (de lo contrario, no existiría ninguna cadena y el servidor fallaría rápidamente). El valor predeterminado (false) fusiona las cadenas incluidas con las de CHAINS_FILE.

Desarrollo local

El MCP Inspector está configurado como dependencia de desarrollo, por lo que puedes realizar el handshake de MCP y llamar a las herramientas manualmente sin conectar el servidor a un cliente real.

git clone https://github.com/imelon2/blockscout-mcp-server.git
cd blockscout-mcp-server
pnpm install
pnpm run inspect

pnpm run inspect compila primero y abre la interfaz del Inspector: elige el transporte stdio y dirígelo a node dist/index.js. Dos atajos:

Licencia