Mcp Server Motherduck

general MCP Server

Local MCP server for DuckDB and MotherDuck

Install Ready
generalgeneral
2 views521 stars85 forksMIT

Why This Matters

Discovered via unknown and last synced 1w ago.

Install Ready
Source
unknown
Stars
521
Last synced
1w ago
Install
Instructions detected

Install

1. Install the package

uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

2. Add to claude_desktop_config.json

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

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

25
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (25)

Zero-setup

Requires local installation

False

For protocol compatibility only (e.g. with [AWS Bedrock AgentCore Runtime](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-mcp-protocol-contract.html)). Server still maintains global state via the shared DatabaseClient.

8000

Port for HTTP transport

list_columns

List columns of a table/view

True

Use temporary connections for read-only local files

list_databases

List all databases (useful for MotherDuck or multiple attached DBs)

50000

Max characters returned

AWS_SECRET_ACCESS_KEY

AWS secret key for S3 database connections

execute_query

Execute SQL query (DuckDB dialect)

1024

Max rows returned

AWS_ACCESS_KEY_ID

AWS access key for S3 database connections

list_tables

List tables and views

None

SQL to execute on startup

path

`create_if_not_exists`

stdio

Transport type: `stdio` or `http`

AWS_ENDPOINT

AWS endpoint for S3 connections

Client

Config Location

Variable

Description

Parameter

Default

Tool

Description

HOME

Used by DuckDB for extensions and config. Override with `--home-dir` if not set.

AWS_DEFAULT_REGION

AWS region for S3 connections

query

Execute a SQL query on the DuckDB or MotherDuck database

Inputs

`query` (string, required): The SQL query to execute

AWS_SESSION_TOKEN

AWS session token for temporary credentials (IAM roles, SSO, EC2 instance profiles)