mcp-server-duckdb
by ktanaka101·★ 176·Score 42
MCP server for DuckDB database interaction, enabling SQL query execution through MCP tools.
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:
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 READMEqueryquery: stringExecute any SQL query on the DuckDB database
Comparable tools
Installation
Installation
Via Smithery
npx -y @smithery/cli install mcp-server-duckdb --client claudeClaude 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
uvpackage 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
Last updated · Auto-generated from public README + GitHub signals.