DuckDB / MotherDuck MCP Server
DuckDB / MotherDuck Local MCP Server
MCP-сервер для SQL-аналитики на DuckDB: локальные файлы, база в памяти, базы на S3 и MotherDuck
Установка
claude mcp add --scope user duckdb --transport stdio -- uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databasesБаза в памяти с записью и переключением баз.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту аналитический SQL-движок DuckDB. Агент выполняет запросы на диалекте DuckDB, смотрит список баз, таблиц и колонок и при включенном флаге переключается между базами на лету. Подключается к базе в памяти, к файлу DuckDB на диске, к файлу на S3 или к облачному MotherDuck. По умолчанию работает только на чтение, запись включается флагом --read-write, объем результата ограничен по строкам и символам.
Для кого. Для аналитиков и дата-инженеров, которые хотят разбирать CSV, Parquet и базы DuckDB через агента.
Подходит, если
- Нужно быстро посчитать что-то по локальным CSV или Parquet без поднятия базы
- Нужно дать агенту доступ к данным в MotherDuck
- Нужно отладить пайплайн данных на DuckDB вместе с агентом
Не подходит, если
- Нужен доступ третьих лиц к серверу: режим только для чтения все равно открывает файловую систему
- Данные лежат в PostgreSQL или ClickHouse и переносить их не нужно
Пример запроса к агенту
Загрузи sales.csv из этой папки и посчитай выручку по месяцамОграничения
Нужен uv. Для MotherDuck нужен токен, а в режиме только для чтения специальный read-scaling токен. Режим только для чтения не закрывает доступ к локальной файловой системе и настройкам DuckDB, для внешних пользователей авторы советуют удаленный MCP MotherDuck. С локальными файлами внешние сервисы не нужны, доступность MotherDuck из России не проверена.
Как отключить. Выполните claude mcp remove duckdb или удалите блок сервера из конфигурации клиента.
MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| motherduck_token секрет | Токен MotherDuck, нужен только для md: |
| AWS_ACCESS_KEY_ID секрет | Ключ доступа для баз на S3 |
| AWS_SECRET_ACCESS_KEY секрет | Секретный ключ для баз на S3 |
Проверка безопасности
- Выполняет SQL с доступом к локальной файловой системе
- В режиме записи может менять и удалять данные
Коротко о README
README сравнивает локальный сервер с удаленным MCP MotherDuck и дает три готовых конфига: база в памяти, локальный файл только для чтения и MotherDuck с записью. Есть команды для Claude Code, Codex и Gemini CLI, пакет MCPB для Claude Desktop и кнопки установки для Cursor, VS Code и Kiro. Описаны инструменты, запуск в Docker по HTTP, параметры командной строки и советы по безопасности. Лицензия MIT.
Частые вопросы
Чем этот сервер отличается от удаленного MCP MotherDuck?
Удаленный размещен MotherDuck и не требует установки, но не видит локальные файлы. Этот сервер работает у вас и может читать и выгружать данные на диск.
Что изменилось после версии 0.x?
Сервер по умолчанию стал только для чтения, а база по умолчанию сменилась с MotherDuck на базу в памяти.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Экономный по токенам MCP-сервер для PostgreSQL, MySQL, MariaDB, SQL Server и SQLite с режимом только для чтения