nuthatch — MCP-сервер для Claude Code: SQL по истории EVM-контракта
Локальный MCP-сервер, который превращает историю EVM-контракта в SQL-базу. Пригодится, когда нужно запросить события контракта без сабграфа и Postgres.
claude mcp add nuthatch -- docker run -i --rm ghcr.io/nightswatchhq/nuthatch:4.0.0Что делает nuthatch
nuthatch — один бинарник на Rust. Он разрешает ABI контракта через Sourcify или Etherscan, генерирует схему и декодеры, а события становятся таблицами, к которым вы обращаетесь обычным аналитическим SQL. Данные лежат на вашей машине: до 2 ГБ RAM на цепочку, без телеметрии и без обязательного API-токена.
Установка идёт через curl -fsSL https://nuthatch-indexer.com/install.sh | sh, скрипт кладёт бинарник в ~/.local/bin. Дальше nuthatch init 0x… --alias weth создаёт nest — каталог с ABI, конфигом и проиндексированными данными, а nuthatch dev --backfill 300 начинает с отставания в 300 блоков. Без --backfill индексация пойдёт от блока деплоя контракта.
Linux-сборке нужен glibc 2.35 или новее. На Debian 12 и Ubuntu 22.04 всё запустится, а на RHEL 9 и Amazon Linux 2023 с glibc 2.34 понадобится сборка из исходников на Rust 1.95.0. Готовой сборки под Intel Mac нет — там тоже только исходники. Публичные RPC в комплекте годятся для пробы, а не для постоянной работы: для длинной индексации берите свой эндпоинт через --rpc.
Какие задачи решает
- запросить события контракта на SQL без сабграфа
- поднять локальный индекс истории контракта без Postgres и Docker
- отдать агенту доступ к данным контракта через MCP
- проверить состояние контракта на последних блоках
- получить таблицы из ABI без написания обработчиков
Примеры запросов агенту
- Подключи MCP-сервер nuthatch и покажи, сколько переводов было у WETH за последние 300 блоков
- Через nuthatch посчитай число событий
transferв таблицеweth__transfer - Запусти nuthatch и выведи последние записи из индекса контракта
Как установить nuthatch
Командой платформы
claude mcp add nuthatch -- docker run -i --rm ghcr.io/nightswatchhq/nuthatch:4.0.0Командой платформы
codex mcp add nuthatch -- docker run -i --rm ghcr.io/nightswatchhq/nuthatch:4.0.0Файл настроек
{
"mcpServers": {
"nuthatch": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nightswatchhq/nuthatch:4.0.0"
]
}
}
}Файл настроек
{
"servers": {
"nuthatch": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nightswatchhq/nuthatch:4.0.0"
]
}
}
}Командой платформы
gemini mcp add nuthatch docker run -i --rm ghcr.io/nightswatchhq/nuthatch:4.0.0По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о nuthatch
Как установить nuthatch в Claude Code?
Выполните claude mcp add nuthatch -- docker run -i --rm ghcr.io/nightswatchhq/nuthatch:4.0.0.
Что делает nuthatch?
Индексирует историю EVM-контракта в локальную SQL-базу и отдаёт её через встроенный MCP-сервер. Таблицы строятся из ABI, писать код обработчиков не нужно.
Какие требования у nuthatch?
Нужен RPC-эндпоинт к сети, а Linux-бинарнику — glibc 2.35 или новее. Для Intel Mac и старых дистрибутивов придётся собирать из исходников на Rust 1.95.0.
