HutchDB — база данных для ИИ-агентов

HutchDB

MCP-сервер HutchDB: общие записи агентов в Postgres, коллекции без схемы, поиск и фильтры для Claude Code и Cursor

26 ★ репозитория
Последний коммит 9 нояб. 2026

expeditedprojects/hutchdbАвтор:ExpeditedProjects

Установка

Работает в: Claude Code
Cursor
Codex
VS Code
SourceCraft
Koda
Coddy

Ручная установка

docker compose up

После git clone https://github.com/ExpeditedProjects/hutchdb в папке проекта; затем добавьте сервер в MCP-конфиг.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

Без HUTCH_API_KEY сервер доверяет всем запросам, и данные на открытом хосте доступны любому
Агент пишет, меняет и удаляет записи в вашей базе Postgres

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

HutchDB Core — безголовый однопользовательский MCP-сервер с базой Postgres, которую вы контролируете. Агенты Claude Code, Codex, Cursor и VS Code читают и обновляют одни и те же коллекции между сессиями. Записи хранятся как произвольный JSON в JSONB. Коллекция создается при первой записи, схема необязательна. Запросы идут по фильтрам с операторами в стиле Mongo ($gt, $in, $exists, $contains), а также по полнотекстовому поиску. Инструменты с префиксом hutch_ работают с коллекциями, записями, схемой и представлениями, умеют импорт и экспорт в CSV и JSON. Типичные применения: накопление исследований, трекеры вместо таблиц, конвейеры, где один агент собирает данные, а другой их обрабатывает по полю статуса, и рабочая память долгого проекта. Облачная версия HutchDB Cloud добавляет веб-интерфейс, OAuth и организации, в ядре их нет.

Для кого. Разработчикам и аналитикам, чьи агенты копят данные между сессиями и которым мало файла TODO.md или заметок в Markdown.

Подходит, если

Несколько агентов обновляют один список и не должны перезаписывать правки друг друга
Исследование растет сессия за сессией, и позже нужно спросить, что изменилось с прошлого месяца
Баги, заявки или контент-план удобнее держать записями, чтобы агент фильтровал открытые по серьезности
Один агент собирает лиды, второй обогащает их, и статус записи отмечает этап конвейера
Решения и открытые вопросы проекта должны пережить закрытие контекстного окна

Не подходит, если

Нужен веб-интерфейс, публикация страниц или вход через соцсети: они есть только в HutchDB Cloud
Нужно подключить сервер к claude.ai в браузере: в ядре нет сервера OAuth, и веб-клиенту он обязателен
Данные много раз больше обычного агентского блокнота и требуют строгой схемы и сложных соединений: это не реляционная СУБД

Пример запроса к агенту

Сохрани эти пять страниц с ценами конкурентов в коллекцию competitor-pricing и скажи, кто менял цены с прошлого месяца

MCP

Транспорт: http
Авторизация: ключ необязателен

Переменные окружения

HUTCH_API_KEY секрет: Статический ключ: если задан, каждый вызов MCP требует Bearer-токен. Без него все запросы считаются доверенными.
HUTCH_DATABASE_URL секрет: Строка подключения к Postgres при запуске без Docker.

Ограничения

Ядро однопользовательское и без панели управления. Без переменной HUTCH_API_KEY сервер доверяет всем запросам: для localhost это допустимо, на открытом хосте нет. Для запуска нужен Docker или Node с Postgres и переменной HUTCH_DATABASE_URL.

Лицензия AGPL v3. Авторы пишут, что проект достаточно стабилен для личного развертывания, а несовместимые изменения попадают прямо в main, поэтому для стабильности фиксируйте коммит. Клиенты Claude Code, Cursor, Codex и VS Code работают со статическим токеном, claude.ai в вебе без OAuth не подключается.

Как отключить. Удалите запись hutch из конфигурации MCP и остановите контейнер командой docker compose down в папке проекта. Данные остаются в вашей базе Postgres, их удаляют отдельно.

Частые вопросы

Как запустить HutchDB для Claude Code?

Склонируйте репозиторий и выполните docker compose up, ядро поднимется на порту 3000. В MCP-конфиг добавьте сервер с типом http, адресом http://localhost:3000/api/mcp и заголовком Authorization с вашим токеном.

Нужно ли описывать схему коллекции?

Нет. Коллекция создается при первой записи, а запись может быть любым JSON. Схему можно описать позже и включить проверку; инструменты схемы умеют ее определить по данным.

Чем HutchDB Core отличается от HutchDB Cloud?

Ядро с открытым кодом, однопользовательское и без интерфейса. Облако добавляет веб-панель, опубликованные страницы, OAuth 2.1, вход через соцсети и организации, а с ним работает claude.ai в вебе.

Как защитить сервер на открытом хосте?

Задайте HUTCH_API_KEY, например командой openssl rand -hex 32, до запуска. Тогда каждый вызов MCP должен нести Bearer-токен. Без ключа сервер доверяет всем.

Как перенести данные?

Коллекции экспортируются и импортируются в CSV и JSON инструментами записей.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

DBHub

Выбор редакции

Экономный по токенам MCP-сервер для PostgreSQL, MySQL, MariaDB, SQL Server и SQLite с режимом только для чтения

MCP-серверШирокий доступ3,8 тыс.

WhoDB

Официальный

Легкое рабочее место для баз данных с MCP-сервером: агент читает схему, выполняет запросы и разбирает данные в PostgreSQL, MySQL и других

MCP-серверШирокий доступ5,1 тыс.

LazyDB

Терминальный клиент баз данных на Rust с MCP и JSON CLI: агент читает схему и запускает запросы с правами профиля.

CLIРасширенный доступ67

MCP Database Server

Один MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON

MCP-серверШирокий доступ391

DBCrust

CLI для десятков баз данных с режимом для агентов: JSON на выходе, режим только для чтения, лимиты и брокер, скрывающий пароли

CLIШирокий доступ92

DataHub MCP Server