mcp-server-motherduck — MCP-сервер для Claude Code: обзор
Локальный сервер для выполнения аналитических SQL-запросов через DuckDB и MotherDuck. Открывает ИИ-ассистентам доступ к локальным файлам баз данных, памяти и облачным хранилищам.
claude mcp add mcp-server-motherduck -e motherduck_token=<motherduck_token> -e MOTHERDUCK_TOKEN=<MOTHERDUCK_TOKEN> -e AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> -e AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> -e AWS_SESSION_TOKEN=<AWS_SESSION_TOKEN> -- uvx mcp-server-motherduckЧто делает mcp-server-motherduck
Сервер связывает ассистента с движком DuckDB на вашей машине. Он умеет читать схемы каталогов и выполнять выборки данных. Поддерживаются локальные файлы .duckdb, оперативная память :memory: или облачные базы MotherDuck. При переключении в режим чтения сервер не захватывает файловую блокировку, поэтому к одному файлу можно обращаться параллельно из других процессов.
Для запуска требуется менеджер uv. Утилита стартует через uvx с флагами пути --db-path, разрешения записи --read-write и смены баз на лету --allow-switch-databases. Без переменных окружения с токеном motherduck_token или ключами AWS подключиться к удалённым источникам не получится.
Какие задачи решает
- Выполнять аналитические SQL-запросы к локальным файлам DuckDB
- Исследовать структуру таблиц и каталогов базы данных через диалог
- Импортировать данные из локальных файлов прямо в таблицы MotherDuck
- Запускать быстрые расчёты в оперативной памяти без создания файлов
Примеры запросов агенту
- Покажи список таблиц и первые 10 строк из схемы public в базе ./analytics.duckdb
- Создай временную таблицу в памяти из файла data.csv и посчитай выручку по регионам
- Выполни аналитический запрос к таблице orders в базе MotherDuck
Как установить mcp-server-motherduck
Командой платформы
claude mcp add mcp-server-motherduck -e motherduck_token=<motherduck_token> -e MOTHERDUCK_TOKEN=<MOTHERDUCK_TOKEN> -e AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> -e AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> -e AWS_SESSION_TOKEN=<AWS_SESSION_TOKEN> -- uvx mcp-server-motherduckВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-motherduck <команда>
Командой платформы
codex mcp add mcp-server-motherduck --env motherduck_token=<motherduck_token> --env MOTHERDUCK_TOKEN=<MOTHERDUCK_TOKEN> --env HOME=<HOME> --env AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> --env AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> -- uvx mcp-server-motherduckВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-motherduck <команда>
Файл настроек
{
"mcpServers": {
"mcp-server-motherduck": {
"command": "uvx",
"args": [
"mcp-server-motherduck"
],
"env": {
"motherduck_token": "<motherduck_token>",
"MOTHERDUCK_TOKEN": "<MOTHERDUCK_TOKEN>",
"HOME": "<HOME>",
"AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
"AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-motherduck <команда>
Файл настроек
{
"servers": {
"mcp-server-motherduck": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-server-motherduck"
],
"env": {
"motherduck_token": "<motherduck_token>",
"MOTHERDUCK_TOKEN": "<MOTHERDUCK_TOKEN>",
"HOME": "<HOME>",
"AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
"AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-motherduck <команда>
Командой платформы
gemini mcp add -e motherduck_token=<motherduck_token> -e MOTHERDUCK_TOKEN=<MOTHERDUCK_TOKEN> -e HOME=<HOME> -e AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> -e AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> mcp-server-motherduck uvx mcp-server-motherduckВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-motherduck <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-server-motherduck
Как установить mcp-server-motherduck в Claude Code?
Выполните команду `claude mcp add mcp-server-motherduck -e motherduck_token=<motherduck_token> -e MOTHERDUCK_TOKEN=<MOTHERDUCK_TOKEN> -e AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> -e AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> -e AWS_SESSION_TOKEN=<AWS_SESSION_TOKEN> -- uvx mcp-server-motherduck. Предварительно установите пакетный менеджер uv`.
Что делает mcp-server-motherduck?
Он даёт языковой модели доступ к инструментам SQL-аналитики DuckDB. Ассистент сможет читать схемы, выполнять запросы и управлять данными локально или в облаке.
Чем полезен режим чтения для DuckDB?
В режиме только для чтения движок не удерживает исключительную блокировку файла. Это позволяет параллельно работать с этой же базой в других скриптах или приложениях.
