MCP Catalogs
Home

mcp-server-duckdb

by ktanaka101·176·Score 42

MCP server for DuckDB database interaction, enabling SQL query execution through MCP tools.

databasedeveloper-toolsai-llm
21
Forks
6
Open issues
13 mo ago
Last commit
2d ago
Indexed

Overview

mcp-server-duckdb is a Python-based implementation that provides database interaction capabilities through the Model Context Protocol. It enables users to execute any valid DuckDB SQL query via a unified query function, offering flexibility for various database operations including SELECT, CREATE TABLE, JOIN, and more. The server supports both read-only and write modes, with configurable parameters for database path and connection handling. While it lacks custom resources and prompts currently, it provides core database functionality suitable for local data analysis with LLM integration.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Enabling LLMs to query and analyze local DuckDB databases without direct database access
you:Facilitating data exploration and analysis through natural language SQL generation
you:Providing a secure read-only interface for database inspection in sensitive environments
you:Can I use this server with other LLM clients besides Claude?
you:How do I enable write operations on the database?

When to choose this

Choose this when you need to enable AI models to query local DuckDB databases without requiring specialized database access setup.

When NOT to choose this

Don't choose this if you need write access to the database in multi-user environments, as there's no built-in authentication or concurrent access control.

Tools this server exposes

1 tool extracted from the README
  • queryquery: string

    Execute any SQL query on the DuckDB database

Comparable tools

mcp-server-postgresmcp-server-mysqlsqlite-mcpduckdb-shell

Installation

Installation

Via Smithery

npx -y @smithery/cli install mcp-server-duckdb --client claude

Claude Desktop Integration

Add to your claude_desktop_config.json:

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

Requirements

  • Python with uv package manager
  • DuckDB Python package

FAQ

Can I use this server with other LLM clients besides Claude?
Yes, the MCP protocol is client-agnostic. While the example shows Claude Desktop integration, it should work with any MCP-compliant client.
How do I enable write operations on the database?
By default, write operations are allowed. To disable them, use the `--readonly` flag when starting the server.

Compare mcp-server-duckdb with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.