Warehouse MCP

Warehouse MCP

kalehdooApache-2.0
warehouse-mcp — это MCP-сервер для подключения AI-ассистентов к реляционным базам данных и облачным хранилищам. Сервер поддерживает Postgres, Oracle, Snowflake, BigQuery, Redshift, DuckDB и MotherDuck. Он гарантирует read-only доступ: ни один запрос не изменит данные. В дополнение к базовой изоляции реализована пятиуровневая ролевая модель, опциональная имперсонация роли хранилища (для RLS/CLS), аудит всех запросов в JSONL, маскирование PII и семантический слой с глоссарием. Такая комбинация делает его подходящим для аналитики, создания отчётов и интеграции с AI без риска повредить данные. Сервер доступен через npx, Docker или облачную версию. Сервер использует протокол MCP и предоставляет 16 инструментов для взаимодействия с хранилищем. Вы можете выполнять произвольные SQL-запросы, просматривать схему и структуру данных, получать метаданные. Все операции строго read-only, проверка выполняется на уровне сервера.
Базы данныхPostgreSQL
Подключить MCPОткрыть на GitHubОфициальный сайт
Подключение

Подключить Warehouse MCP

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

Куда подключить

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "warehouse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "warehouse-mcp"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить Warehouse MCP

Warehouse MCP относится к Базы данных, PostgreSQL. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
Apache-2.0
Реализация
JavaScript
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 2.

Характеристики

Общее

  • СтатусСообщество
  • Разработчикkalehdoo
  • ЛицензияApache-2.0

Технологии

  • Языки
    JavaScript
  • Транспорт
    stdio

Описание

Возможности

  • Подключение к семи типам СУБД: Postgres 12+, Oracle 12c, Amazon Redshift, Snowflake, Google BigQuery, DuckDB (локальный файл или in-memory) и MotherDuck.
  • 16 read-only инструментов: выполнение SQL-запросов, описание таблиц, просмотр списка объектов, метаданные и другие.
  • Гарантия read-only: сервер блокирует любые запросы на изменение данных (INSERT, UPDATE, DELETE, DDL).
  • Пятиуровневая модель доступа на основе ролей и объектных привилегий.
  • Опциональная имперсонация роли хранилища для использования Row-Level Security и Column-Level Security.
  • Полный аудит в формате JSONL: все запросы логируются с указанием пользователя, времени и результата.
  • Маскирование персональных данных (PII) в результатах запросов (например, email, телефон).
  • Семантический слой: можно добавить глоссарий терминов и описание таблиц для улучшения понимания данных ассистентом.
  • Per-session toggle: для каждого запроса можно включить или отключить семантический слой.
  • Развёртывание одной командой: npx -y warehouse-mcp, Docker-образ ghcr.io/kalehdoo/warehouse-mcp или облачная версия (планируется).
  • Поддержка временных таблиц (in-memory для DuckDB) и локальных файлов.
  • Open-source (Apache 2.0), можно самостоятельно собирать и дорабатывать.

Как подключить

Установите сервер через npx:

npx -y warehouse-mcp

Добавьте конфигурацию в ваш MCP-клиент. Пример для Claude Desktop:

{ "mcpServers": { "warehouse": { "command": "npx", "args": ["-y", "warehouse-mcp"], "env": { "WAREHOUSE_TYPE": "postgres", "WAREHOUSE_HOST": "localhost", "WAREHOUSE_PORT": "5432", "WAREHOUSE_NAME": "analytics", "WAREHOUSE_USER": "readonly_user", "WAREHOUSE_PASSWORD": "secure_password", "WAREHOUSE_ACCESS_MODE": "read_only" } } } }

Перезапустите клиент. Для других хранилищ используйте соответствующие переменные окружения (см. документацию адаптера).

Для запуска через Docker выполните:

docker pull ghcr.io/kalehdoo/warehouse-mcp:latest

и передайте те же переменные окружения при старте контейнера.

Примеры запросов

  • «Покажи список таблиц в схеме public с комментариями»
  • «Найди все заказы за последние 7 дней и выведи сумму по статусам»
  • «Опиши структуру таблицы customers: типы колонок, ограничения, комментарии»
  • «Выполни SQL: SELECT month, SUM(total) FROM sales GROUP BY month ORDER BY month»
  • «Создай отчёт по выручке по категориям за 2024 год»

Технические детали

  • Язык разработки: JavaScript (Node.js)
  • Транспорт: stdio
  • Лицензия: Apache-2.0 (открытая)
  • Версия: v0.4.x — production-ready
  • Совместимость: Claude Desktop, Cursor и любые MCP-клиенты с поддержкой stdio
  • Поддерживаемые СУБД: Postgres, Oracle, Redshift, Snowflake, BigQuery, DuckDB, MotherDuck
  • Подробная документация по адаптерам в репозитории проекта

Поделиться