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 не изолирует файловую систему.
Настройка клиентов
{
"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.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.