blockscout-mcp-server

Сервер MCP с доступом только на чтение через stdio, который предоставляет ИИ-агентам мультичейн-данные EVM из on-chain — адреса, транзакции, блоки, логи, токены, NFT и исходный код контрактов — через REST API Blockscout.

[!IMPORTANT] Это не официальный MCP-сервер Blockscout. Это кастомный, независимо созданный сервер, который поддерживается отдельным разработчиком и не связан с командой Blockscout и не одобрен ею.

Быстрый старт

npx загружает опубликованный пакет и запускает его — ничего устанавливать вручную не нужно. Работает из любого проекта; укажите CHAINS_FILE на файл цепочек этого проекта (относительный ./chains.json разрешается относительно рабочей директории клиента).

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

Реестр цепочек и переменные окружения читаются один раз при запуске. После изменения конфигурации или кода перезапустите (переподключите) сервер в вашем MCP-клиенте. В комплекте идёт готовый к редактированию .mcp.example.json.

Related MCP server: Onesource MCP

Поддерживаемые цепочки

Эти цепочки зарегистрированы из коробки из встроенного снимка (src/chains/bundled.json) — никакой настройки не требуется. Аргумент chain любого инструмента принимает либо имя (ethereum), либо числовой идентификатор цепочки (1).

Вызовите инструмент get_chains_list, чтобы увидеть цепочки, фактически зарегистрированные на запущенном сервере.

Пользовательские цепочки

Укажите CHAINS_FILE на JSON-файл, описывающий дополнительные цепочки (или переопределяющий встроенные). Каждая запись должна содержать name, chainId и url инстанса Blockscout:

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

Если CHAINS_FILE задан, но файл отсутствует или повреждён, сервер немедленно завершает работу (fail-fast).

Установите ONLY_CHAINS_FILE=true, чтобы зарегистрировать только цепочки из CHAINS_FILE и полностью исключить встроенный снимок. Для этого требуется, чтобы CHAINS_FILE был задан (иначе цепочек не было бы вовсе, и сервер завершился бы с ошибкой). Значение по умолчанию (false) объединяет встроенные цепочки с CHAINS_FILE.

Локальная разработка

MCP Inspector подключён как dev-зависимость, так что вы можете пройти через MCP handshake и вызывать инструменты вручную, не подключая сервер к реальному клиенту.

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

pnpm run inspect сначала собирает проект, затем открывает интерфейс Inspector — выберите транспорт stdio и укажите node dist/index.js. Два сокращения:

Лицензия

MIT