motherduckdb/mcp-server-motherduck

motherduckdb/mcp-server-motherduck

от motherduckdb
MCP сервер для SQL аналитики, соединяющий AI-помощников с DuckDB. Работает с локальными файлами, S3 и MotherDuck. Выполняйте запросы, исследуйте схемы, переключайте соединения. Полезен разработчикам и аналитикам.

MotherDuck / DuckDB Local MCP Server

DuckDB / MotherDuck Local MCP Server

SQL analytics and data engineering for AI Assistants and IDEs.


Connect AI assistants to your data using DuckDB's powerful analytical SQL engine. Supports connecting to local DuckDB files, in-memory databases, S3-hosted databases, and MotherDuck. Allows executing SQL read- and write-queries, browsing database catalogs, and switching between different database connections on-the-fly.

Looking for a fully-managed remote MCP server for MotherDuck? → Go to the MotherDuck Remote MCP docs

Remote vs Local MCP
Remote MCP Local MCP (this repo)
Hosting Hosted by MotherDuck Runs locally/self-hosted
Setup Zero-setup Requires local installation
Access Read-write supported Read-write supported
Local filesystem - Query across local and remote databases, ingest data from / export data to local filesystem

Quick Start

Prerequisites: Install uv via pip install uv or brew install uv

Connecting to In-Memory DuckDB (Dev Mode)
{
  "mcpServers": {
    "DuckDB (in-memory, r/w)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", ":memory:", "--read-write", "--allow-switch-databases"]
    }
  }
}

Часто задаваемые вопросы

Инструменты были проиндексированы:
execute_query

Выполняет SQL-запрос в базе данных DuckDB или MotherDuck. Неполные имена таблиц автоматически разрешаются в current_database() и current_schema(). Полные имена (database.schema.table) требуются только тогда, когда подключено несколько баз данных DuckDB или при подключении к MotherDuck.

Выполняет запрос.

Параметры
  • sqlstringобязательный

    SQL-запрос для выполнения (диалект SQL DuckDB)

list_columnsтолько чтение

Перечисляет все столбцы таблицы или представления с их типами и комментариями. Если база данных/схема не указаны, использует текущую базу данных/схему.

Выводит список колонок.

Параметры
  • databasestring | null

    Имя базы данных (по умолчанию используется текущая база данных)

  • schemastring | null

    Имя схемы (по умолчанию — текущая схема)

  • tablestringобязательный

    Имя таблицы или представления

list_databasesтолько чтение

Перечисляет все базы данных, доступные в подключении. Полезно, когда подключено несколько баз данных DuckDB или при подключении к MotherDuck.

Выводит список баз данных.

Параметры

Без параметров.

list_tablesтолько чтение

Перечисляет все таблицы и представления в базе данных с их комментариями. Если база данных не указана, использует текущую базу данных.

Перечисляет таблицы.

Параметры
  • databasestring | null

    Имя базы данных для вывода списка таблиц (по умолчанию: текущая база данных)

  • schemastring | null

    Необязательное имя схемы для фильтрации

switch_database_connectionвнешний мир

Переключитесь на другое подключение к базе данных. Для локальных файлов используйте только абсолютные пути. Новое подключение учитывает режим read-only/read-write сервера. Для локальных файлов файл должен существовать, если только create_if_not_exists=True (требуется режим read-write).

Переключает подключение к базе данных

Параметры
  • create_if_not_existsboolean

    Если True, создает файл базы данных, если он не существует. Работает только в режиме чтения-записи.

  • pathstringобязательный

    Путь к базе данных. Для локальных файлов должен быть абсолютным. Также принимает пути вида :memory:, md:database_name или s3://.

1.1.0основная
1.0.8
1.0.7
1.0.6
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1
1.0.0
0.8.1
0.8.0
0.7.2
0.7.1
0.7.0
0.6.4
0.6.3
0.6.2
0.6.1
0.6.0
0.5.1
0.5
0.4.2
0.4.1
0.4.0
0.3.4
0.3.3
0.3.2
0.3.1
0.3
0.2.2
0.2.1
0.2.0
0.1.0

Выберите клиент, чтобы установить motherduckdb/mcp-server-motherduck:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "motherduckdb-mcp-server-motherduck-63ry": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        ":memory:",
        "--read-write",
        "--allow-switch-databases"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "motherduckdb-mcp-server-motherduck-63ry": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        ":memory:",
        "--read-write",
        "--allow-switch-databases"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "motherduckdb-mcp-server-motherduck-63ry": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        ":memory:",
        "--read-write",
        "--allow-switch-databases"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"motherduckdb-mcp-server-motherduck-63ry\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-server-motherduck\",\"--db-path\",\":memory:\",\"--read-write\",\"--allow-switch-databases\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "motherduckdb-mcp-server-motherduck-63ry": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        ":memory:",
        "--read-write",
        "--allow-switch-databases"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add motherduckdb-mcp-server-motherduck-63ry -- uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

Либо через JSON-конфиг:

claude mcp add-json motherduckdb-mcp-server-motherduck-63ry "{\"command\":\"uvx\",\"args\":[\"mcp-server-motherduck\",\"--db-path\",\":memory:\",\"--read-write\",\"--allow-switch-databases\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add motherduckdb-mcp-server-motherduck-63ry -- uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.motherduckdb-mcp-server-motherduck-63ry]
command = "uvx"
args = ["mcp-server-motherduck", "--db-path", ":memory:", "--read-write", "--allow-switch-databases"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите motherduckdb/mcp-server-motherduck, а в поле команды запуска — строку ниже:
uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "motherduckdb-mcp-server-motherduck-63ry": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        ":memory:",
        "--read-write",
        "--allow-switch-databases"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "motherduckdb-mcp-server-motherduck-63ry": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        ":memory:",
        "--read-write",
        "--allow-switch-databases"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например motherduckdb-mcp-server-motherduck-63ry.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: motherduckdb-mcp-server-motherduck-63ry
    command: uvx
    args:
      - "mcp-server-motherduck"
      - "--db-path"
      - ":memory:"
      - "--read-write"
      - "--allow-switch-databases"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "motherduckdb-mcp-server-motherduck-63ry": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        ":memory:",
        "--read-write",
        "--allow-switch-databases"
      ]
    }
  }
}

Похожие MCP-сервера

lucashild/mcp-server-bigquery

lucashild/mcp-server-bigquery

от lucashild

MCP сервер для Google BigQuery: LLM просматривает схемы таблиц и выполняет SQL-запросы. Полезен аналитикам и разработчикам для AI-интеграции с данными.

Python⭐ 131
hydrolix/mcp-hydrolix

hydrolix/mcp-hydrolix

от hydrolix

MCP-сервер для выполнения SQL-запросов к Hydrolix: получай данные, список баз и таблиц, схему. Помогает разработчикам и аналитикам работать с Hydrolix через Claude Desktop, Claude Code или VS Code ...

Python⭐ 11
ktanaka101/mcp-server-duckdb

ktanaka101/mcp-server-duckdb

от ktanaka101

MCP сервер для DuckDB позволяет LLM выполнять SQL-запросы, создавать таблицы и просматривать схему. Для локального анализа: откройте .db-файл в режиме read-only или с постоянным подключением. Устан...

Python⭐ 179
pab1it0/adx-mcp-server

pab1it0/adx-mcp-server

от pab1it0

Этот MCP сервер открывает AI-агентам доступ к Azure Data Explorer: выполняет KQL запросы, показывает схемы таблиц, выборки и статистику. Настраивается под нужные инструменты, работает через Docker и разные способы логина. Полезен аналитикам и разработчикам.

Python⭐ 58
starrocks/mcp-server-starrocks

starrocks/mcp-server-starrocks

от starrocks

MCP сервер для StarRocks: выполняет SQL-запросы, исследует схемы, извлекает метрики и строит Plotly-графики. Помогает разработчикам и аналитикам быстро анализировать данные через AI-ассистентов без сложной настройки.

Python⭐ 195
jovezhong/mcp-timeplus

jovezhong/mcp-timeplus

от jovezhong

MCP сервер для интеграции Timeplus с AI-ассистентами: выполняйте SQL-запросы, управляйте базами, таблицами и Kafka-потоками, настраивайте ETL и подключайтесь к Apache Iceberg. Удобен для аналитики реального времени.

Python⭐ 12
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин