
mcp-server-motherduck
motherduckdbv1.1.1MIT
544 звёзд90 форков
MCP-сервер на DuckDB для подключения AI-ассистентов и сред разработки к аналитическим данным. Инструмент для инженеров данных, аналитиков и бэкенд-разработчиков, которые хотят взаимодействовать с базами через естественный язык.
Сервер работает с четырьмя типами подключений: база в оперативной памяти для прототипирования, локальный файл DuckDB для проектов, облачная платформа MotherDuck для командной работы и S3-совместимые хранилища для удалённых данных. По умолчанию включён безопасный режим «только чтение». Чтобы разрешить запись (INSERT, UPDATE, CREATE), запускайте сервер с флагом --read-write.
- Официальный сервер
- Локальный запуск (stdio)
- Python
- Лицензия MIT
- Обновлён 14 ноября 2026 г.
Подключение
Подключить mcp-server-motherduck
Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.
1
Способ подключения
2
Куда подключить
3
Скопируйте и проверьте
Claude Desktop / Claude Code
Локальный MCP-сервер запускается этой командой из конфигурации выбранного клиента.
- 1.Откройте настройки MCP в Claude.
- 2.Добавьте сервер с указанной командой и переменными окружения.
- 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
"mcpServers": {
"mcp-server-motherduck": {
"command": "uvx",
"args": [
"mcp-server-motherduck"
]
}
}
}Перед подключением сверьте команду с README проекта, замените шаблонные токены и предоставьте только необходимые права доступа.
Характеристики
Общее
- СтатусОфициальный
- Разработчикmotherduckdb
- Версияv1.1.1
- ЛицензияMIT
- Последний релиз11.11.2026
- Активность источника14.11.2026
Технологии
- ЯзыкиPython
- Транспортstdio — локальный запуск
Описание
Возможности
- Выполнять SQL-запросы любой сложности: JOIN, подзапросы, оконные функции, агрегации.
- Подключаться к базам DuckDB в памяти, локальным .duckdb-файлам и облаку MotherDuck.
- Запрашивать данные из S3-хранилищ, а также форматов CSV, Parquet, JSON.
- Просматривать полный каталог базы: схемы, таблицы, представления, типы и имена столбцов.
- Переключаться между подключениями на лету без перезапуска сервера (флаг
--allow-switch-databases). - Загружать данные из локальной файловой системы в базу и экспортировать результаты запросов в файлы.
- Создавать, изменять и удалять таблицы, вставлять и обновлять строки (в режиме
--read-write). - Работать с MotherDuck через read-scaling токен для безопасного доступа только на чтение.
- Использовать расширения DuckDB для работы с Parquet, JSON, HTTPS.
Как подключить
Установите менеджер пакетов uv, если его нет:
pip install uv
Добавьте конфигурацию сервера в ваш MCP-клиент. Ниже пример для Claude Desktop.
Режим разработки (память, чтение и запись):
{
"mcpServers": {
"DuckDB (Dev)": {
"command": "uvx",
"args": ["mcp-server-motherduck", "--db-path", ":memory:", "--read-write", "--allow-switch-databases"]
}
}
}
Работа с локальным файлом (только чтение):
{
"mcpServers": {
"DuckDB (Project)": {
"command": "uvx",
"args": ["mcp-server-motherduck", "--db-path", "/путь/к/файлу.duckdb"]
}
}
}
После сохранения конфигурации перезапустите клиент. Сервер готов к выполнению команд.
Примеры запросов
- «Покажи первые 10 строк из таблицы sales в MotherDuck.»
- «Найди средний чек по дням за последнюю неделю. Выгрузи результат в CSV на рабочий стол.»
- «Подключись к базе analytics.duckdb и опиши её полную схему: все таблицы и их столбцы.»
- «Создай таблицу top_customers на основе агрегации заказов с суммой больше 1000.»
- «Объедини данные из локального CSV-файла и таблицы в MotherDuck, выведи результат.»
Технические детали
- Язык разработки: Python
- Транспортный протокол: stdio
- Лицензия: MIT
- Разработчик: MotherDuck
- Количество звёзд на GitHub: 486
- Совместимые клиенты: Claude Desktop, VS Code (через расширение Cline), Cursor, Zed, любой MCP-клиент с поддержкой stdio
- Режим запуска: через
uvx(без предварительной установки) или через Python напрямую



