MCP Server Motherduck

MCP Server Motherduck

motherduckdbMIT
486 звёзд84 форков
MCP-сервер на DuckDB для подключения AI-ассистентов и сред разработки к аналитическим данным. Инструмент для инженеров данных, аналитиков и бэкенд-разработчиков, которые хотят взаимодействовать с базами через естественный язык. Сервер работает с четырьмя типами подключений: база в оперативной памяти для прототипирования, локальный файл DuckDB для проектов, облачная платформа MotherDuck для командной работы и S3-совместимые хранилища для удалённых данных. По умолчанию включён безопасный режим «только чтение». Чтобы разрешить запись (INSERT, UPDATE, CREATE), запускайте сервер с флагом --read-write.
Подключение

Подключить MCP Server Motherduck

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

Куда подключить

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "mcp-server-motherduck": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить MCP Server Motherduck

MCP Server Motherduck относится к AI и машинное обучение, Базы данных. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
MIT
Реализация
Python
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

Характеристики

Общее

  • СтатусСообщество
  • Разработчикmotherduckdb
  • ЛицензияMIT

Технологии

  • Языки
    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 напрямую

Поделиться