Для чего этот сервер?

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

Каталог MCP
ktanaka101/mcp-server-duckdb

ktanaka101/mcp-server-duckdb

от ktanaka101

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

Github PyPi Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

mcp-server-duckdb

PyPI - License

A Model Context Protocol (MCP) server implementation for DuckDB, providing database interaction capabilities through MCP tools. It would be interesting to have LLM analyze it. DuckDB is suitable for local analysis.

Overview

This server enables interaction with a DuckDB database through the Model Context Protocol, allowing for database operations like querying, table creation, and schema inspection.

Components

Resources

Currently, no custom resources are implemented.

Prompts

Currently, no custom prompts are implemented.

Tools

The server implements the following database interaction tool:

query: Execute any SQL query on the DuckDB database
- Input: query (string) - Any valid DuckDB SQL statement
- Output: Query results as text (or success message for operations like CREATE/INSERT)

Заметка
The server provides a single unified query function rather than separate specialized functions, as modern LLMs can generate appropriate SQL for any database operation (SELECT, CREATE TABLE, JOIN, etc.) without requiring separate endpoints.

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

У этого сервера пока нет списка инструментов.

`1.1.0`основная	05.05.2025
`1.0.1`	18.03.2025
`1.0.0`	18.03.2025
`0.2.4`	05.01.2025
`0.2.3`	04.01.2025
`0.2.1`	01.12.2024
`0.2.0`	01.12.2024
`0.1.0`	30.11.2024

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

Любой клиент

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

{
  "mcpServers": {
    "ktanaka101-mcp-server-duckdb-cs1794b0qz": {
      "command": "uvx",
      "args": [
        "mcp-server-duckdb",
        "--db-path",
        "~/mcp-server-duckdb/data/data.db"
      ]
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "ktanaka101-mcp-server-duckdb-cs1794b0qz": {
      "command": "uvx",
      "args": [
        "mcp-server-duckdb",
        "--db-path",
        "~/mcp-server-duckdb/data/data.db"
      ]
    }
  }
}

VS Code

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

{
  "servers": {
    "ktanaka101-mcp-server-duckdb-cs1794b0qz": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-duckdb",
        "--db-path",
        "~/mcp-server-duckdb/data/data.db"
      ]
    }
  }
}

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

code --add-mcp "{\"name\":\"ktanaka101-mcp-server-duckdb-cs1794b0qz\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-server-duckdb\",\"--db-path\",\"~/mcp-server-duckdb/data/data.db\"]}"

Claude 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": {
    "ktanaka101-mcp-server-duckdb-cs1794b0qz": {
      "command": "uvx",
      "args": [
        "mcp-server-duckdb",
        "--db-path",
        "~/mcp-server-duckdb/data/data.db"
      ]
    }
  }
}

Claude Code

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

claude mcp add ktanaka101-mcp-server-duckdb-cs1794b0qz -- uvx mcp-server-duckdb --db-path ~/mcp-server-duckdb/data/data.db

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

claude mcp add-json ktanaka101-mcp-server-duckdb-cs1794b0qz "{\"command\":\"uvx\",\"args\":[\"mcp-server-duckdb\",\"--db-path\",\"~/mcp-server-duckdb/data/data.db\"]}"

Codex

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

codex mcp add ktanaka101-mcp-server-duckdb-cs1794b0qz -- uvx mcp-server-duckdb --db-path ~/mcp-server-duckdb/data/data.db

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

[mcp_servers.ktanaka101-mcp-server-duckdb-cs1794b0qz]
command = "uvx"
args = ["mcp-server-duckdb", "--db-path", "~/mcp-server-duckdb/data/data.db"]

Perplexity

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

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите ktanaka101/mcp-server-duckdb, а в поле команды запуска — строку ниже:

uvx mcp-server-duckdb --db-path ~/mcp-server-duckdb/data/data.db

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

Windsurf

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

{
  "mcpServers": {
    "ktanaka101-mcp-server-duckdb-cs1794b0qz": {
      "command": "uvx",
      "args": [
        "mcp-server-duckdb",
        "--db-path",
        "~/mcp-server-duckdb/data/data.db"
      ]
    }
  }
}

Cline

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

{
  "mcpServers": {
    "ktanaka101-mcp-server-duckdb-cs1794b0qz": {
      "command": "uvx",
      "args": [
        "mcp-server-duckdb",
        "--db-path",
        "~/mcp-server-duckdb/data/data.db"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

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

mcpServers:
  - name: ktanaka101-mcp-server-duckdb-cs1794b0qz
    command: uvx
    args:
      - "mcp-server-duckdb"
      - "--db-path"
      - "~/mcp-server-duckdb/data/data.db"

Zed

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

{
  "context_servers": {
    "ktanaka101-mcp-server-duckdb-cs1794b0qz": {
      "command": "uvx",
      "args": [
        "mcp-server-duckdb",
        "--db-path",
        "~/mcp-server-duckdb/data/data.db"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "mcp-server-duckdb",
    "--db-path",
    "~/mcp-server-duckdb/data/data.db"
  ]
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

Информация о сервере

Номер в рейтинге: #170
Звезд на Github: 179
Форков на Github: 21
Загрузок: 3 841 844
Язык реализации: Python
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.10 в 10:19
Идентификатор: AhjlqGdPx3GwVWTR
Категории: Базы данных

ktanaka101/mcp-server-duckdb

mcp-server-duckdb

Overview

Components

Resources

Prompts

Tools

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

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

ClickHouse/mcp-clickhouse

bytebase/dbhub

JaviMaligno/postgres_mcp

c4pt0r/mcp-server-tidb

jparkerweb/mcp-sqlite

ofershap/mcp-server-sqlite