blockscout-mcp-server

Ein schreibgeschützter stdio-MCP-Server, der KI-Agenten Multichain-EVM-On-Chain-Daten bereitstellt – Adressen, Transaktionen, Blöcke, Logs, Token, NFTs und Vertragsquellcode – über die Blockscout-REST-API.

[!WICHTIG] Dies ist nicht der offizielle Blockscout-MCP-Server. Es handelt sich um einen individuell und unabhängig entwickelten Server, der von einem einzelnen Entwickler gepflegt wird und weder mit dem Blockscout-Team verbunden noch von ihm unterstützt wird.

Schnellstart

npx lädt das veröffentlichte Paket herunter und führt es aus – keine manuelle Installation erforderlich. Funktioniert aus jedem Projekt; setze CHAINS_FILE auf die Chains-Datei des jeweiligen Projekts (eine relative ./chains.json wird relativ zum Arbeitsverzeichnis des Clients aufgelöst).

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

Das Chain-Registry und die Umgebungsvariablen werden nur einmal beim Start gelesen. Nach Änderungen an Konfiguration oder Code den Server in deinem MCP-Client neu starten (neu verbinden). Eine bearbeitbare .mcp.example.json ist enthalten.

Related MCP server: Onesource MCP

Unterstützte Chains

Diese Chains sind standardmäßig aus dem gebündelten Snapshot registriert (src/chains/bundled.json) – keine Konfiguration erforderlich. Das chain-Argument eines beliebigen Tools akzeptiert entweder den Namen (ethereum) oder die numerische Chain-ID (1).

Rufe das Tool get_chains_list auf, um die tatsächlich auf einem laufenden Server registrierten Chains zu sehen.

Benutzerdefinierte Chains

Setze CHAINS_FILE auf eine JSON-Datei, die zusätzliche Chains beschreibt (oder gebündelte überschreibt). Jeder Eintrag benötigt einen name, eine chainId und die Blockscout-Instanz-url:

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

Wenn CHAINS_FILE gesetzt ist, die Datei jedoch fehlt oder fehlerhaft ist, beendet sich der Server sofort (Fail-Fast).

Setze ONLY_CHAINS_FILE=true, um nur die Chains aus CHAINS_FILE zu registrieren und den gebündelten Snapshot vollständig auszuschließen. Dies erfordert, dass CHAINS_FILE gesetzt ist (andernfalls gäbe es keine Chains und der Server schlägt sofort fehl). Der Standardwert (false) führt gebündelte Chains mit CHAINS_FILE zusammen.

Lokale Entwicklung

Der MCP Inspector ist als Dev-Abhängigkeit eingerichtet, sodass du den MCP-Handshake durchgehen und Tools manuell aufrufen kannst, ohne den Server in einen echten Client einzubinden.

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

pnpm run inspect baut zuerst und öffnet dann die Inspector-Oberfläche – wähle den stdio-Transport und richte ihn auf node dist/index.js aus. Zwei Abkürzungen:

Lizenz

MIT