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