mcp-server-motherduck

mcp-server-motherduck — официальный MCP-сервер от motherduckdb. SQL-аналитика и инженерия данных на MotherDuck и DuckDB для ИИ-ассистентов. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
motherduckdb
Лицензия
MIT
Транспорт
stdio
Авторизация
token_env
ОС
Не указана
Языки
python

Уровень риска: high

С --read-write меняет данные, с --allow-switch-databases подключается к любой базе; read-only не изолирует файловую систему.

Настройка клиентов

codex
{
    "code": "codex mcp add duckdb -- uvx mcp-server-motherduck --db-path /absolute/path/to/db.duckdb",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

mcp-server-motherduck — официальный локальный MCP-сервер для DuckDB и MotherDuck. Он подключает ИИ-ассистентов и IDE к аналитическому SQL-движку DuckDB. Поддерживаются локальные файлы DuckDB, базы в памяти, базы на S3 и облачный MotherDuck. Можно выполнять запросы на чтение и запись, просматривать каталоги баз, переключаться между базами, загружать данные из локальной файловой системы и выгружать их туда.

Инструменты:

  • execute_query — выполнить SQL-запрос на диалекте DuckDB;
  • list_databases — список баз, удобно для MotherDuck или нескольких подключённых баз;
  • list_tables и list_columns — таблицы, представления и их столбцы;
  • switch_database_connection — переключиться на другую базу. Работает только с флагом --allow-switch-databases.

Результаты приходят в JSON. По умолчанию выдача ограничена 1024 строками или 50 000 символами, лимиты меняются флагами --max-rows и --max-chars. Есть таймаут запроса --query-timeout, SQL при старте --init-sql и HTTP-транспорт для Docker.

У MotherDuck также есть удалённый MCP-сервер, который размещает сама компания и который не нужно устанавливать. Этот репозиторий — локальная версия, которая работает и с локальной файловой системой.

Кому подойдёт

  • Аналитикам и инженерам данных, которые хотят исследовать CSV, Parquet и базы DuckDB через ассистента.
  • Пользователям MotherDuck, которым нужен доступ к облачным базам из Claude, Codex или Gemini CLI.
  • Тем, кто строит пайплайны данных и проверяет запросы в диалоге.

Похожие серверы — в категории базы данных.

Установка

Нужен uv: pip install uv или brew install uv. Сервер запускается через uvx mcp-server-motherduck. Режим задаётся флагами:

  • --db-path :memory: — база в памяти;
  • --db-path с абсолютным путём к файлу — локальный файл DuckDB;
  • --db-path md: — MotherDuck, нужен токен в motherduck_token;
  • s3://... — база на S3, нужны учётные данные AWS в переменных окружения.

По умолчанию сервер работает только на чтение. Запись включается флагом --read-write. Для Claude Desktop есть пакет .mcpb для установки в один клик.

Подключение к клиентам

Команды приведены дословно из README. Здесь показан вариант с локальным файлом только на чтение. Подробнее — в инструкции как подключить MCP.

claude mcp add --scope user duckdb --transport stdio -- uvx mcp-server-motherduck --db-path /absolute/path/to/db.duckdb

В README есть такие же команды для режимов «база в памяти» и «MotherDuck с записью», а также JSON-конфиги для Claude Desktop, Kiro и других клиентов. Укажите свой путь к файлу базы.

Проверка

Попросите ассистента показать список баз и таблиц (list_databases, list_tables) и выполнить простой запрос. Если клиент пишет spawn uvx ENOENT, укажите полный путь к uvx — его покажет which uvx. Если файл заблокирован, проверьте, что включён --ephemeral-connections (по умолчанию включён) и база не открыта на запись.

Примеры задач

Какие таблицы есть в базе? Покажи топ-10 клиентов по выручке за прошлый квартал.
Загрузи sales.csv в новую таблицу и посчитай продажи по месяцам.

Риски

  • В режиме --read-write ассистент может менять и удалять данные. С флагом --allow-switch-databases он может подключиться к любой базе: локальной, на S3 или в MotherDuck. README прямо называет режим «база в памяти с записью и переключением» режимом без ограничений.
  • Режима только для чтения недостаточно, если доступ получают третьи лица: он всё равно позволяет обращаться к локальной файловой системе и менять настройки DuckDB. Для таких сценариев README рекомендует удалённый MCP от MotherDuck. При размещении у себя используйте сервисный аккаунт с токенами read-scaling или --init-sql с настройками безопасности DuckDB.
  • Токен MotherDuck и ключи AWS храните в переменных окружения и не коммитьте.

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

Можно ли запретить запись?

Да, по умолчанию сервер работает только на чтение. Запись включается флагом --read-write.

Чем локальный сервер отличается от удалённого MotherDuck MCP?

Удалённый размещает MotherDuck, установка не нужна. Локальный запускается у вас и умеет работать с локальными файлами и S3.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

dbx

Запросы агентов к базам данных через подключения, настроенные в DBX.

Риск: medium Лицензия: Apache-2.0 ★ 29 956

XERJ

Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.

Риск: high Лицензия: Apache-2.0 ★ 18 558

MCP Toolbox for Databases

MCP Toolbox for Databases от Google подключает агента к вашим базам данных.

Риск: medium Лицензия: Apache-2.0 ★ 16 830

kubeshark

Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.

Риск: medium Лицензия: Apache-2.0 ★ 12 135

Источники