MotherDuck

DuckDB / MotherDuck ローカルMCPサーバー

AIアシスタントとIDEのためのSQL分析およびデータエンジニアリング。

DuckDBの強力な分析SQLエンジンを使用して、AIアシスタントをデータに接続します。ローカルのDuckDBファイル、インメモリデータベース、S3ホスト型データベース、およびMotherDuckへの接続をサポートします。SQLの読み取りおよび書き込みクエリの実行、データベースカタログの参照、データベース接続のオンザフライ切り替えが可能です。

完全マネージドのリモートMCPサーバー（MotherDuck用）をお探しですか？ → MotherDuckリモートMCPドキュメントへ

リモートMCPとローカルMCPの比較

クイックスタート

前提条件: uvをpip install uvまたはbrew install uvでインストール

インメモリDuckDBへの接続（開発モード）

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

ガードレールなしの完全な柔軟性 — 読み書きアクセスと、実行時に任意のデータベース（ローカルファイル、S3、またはMotherDuck）への切り替えが可能です。

ローカルDuckDBファイルへの読み取り専用モードでの接続

{
  "mcpServers": {
    "DuckDB (read-only)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", "/absolute/path/to/your.duckdb"]
    }
  }
}

特定のDuckDBファイルに読み取り専用モードで接続します。ファイルロックを保持しないため、同じDuckDBファイルへの書き込み接続と併用するのに便利です。s3://bucket/path.duckdbを使用してS3上のリモートDuckDBファイルにも接続できます — S3認証については環境変数を参照してください。MCPへの第三者アクセスを検討している場合は、本番環境のセキュリティを参照してください。

MotherDuckへの読み書きモードでの接続

{
  "mcpServers": {
    "MotherDuck (local, r/w)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", "md:", "--read-write"],
      "env": {
        "motherduck_token": "<YOUR_MOTHERDUCK_TOKEN>"
      }
    }
  }
}

その他のオプションについてはコマンドラインパラメータ、デプロイメントのガイダンスについては本番環境のセキュリティ、問題が発生した場合はトラブルシューティングを参照してください。

クライアントのセットアップ

クライアント	設定場所	ワンクリックインストール
Claude Desktop	設定 → 開発者 → 設定を編集	.mcpb（MCPバンドル）
Claude Code	以下のCLIコマンドを使用	-
Codex CLI	以下のCLIコマンドまたは~/.codex/config.tomlを使用	-
Gemini CLI	以下のCLIコマンドまたは~/.gemini/settings.jsonを使用	-
Cursor	設定 → MCP → 新しいグローバルMCPサーバーを追加
VS Code	Ctrl+Shift+P → 「基本設定: ユーザー設定を開く (JSON)」
Kiro	~/.kiro/settings/mcp.json（グローバル）または.kiro/settings/mcp.json（プロジェクト）

MCP互換のクライアントはすべてこのサーバーを使用できます。クイックスタートのJSON設定をクライアントのMCP設定ファイルに追加してください。設定ファイルの場所については、クライアントのドキュメントを参照してください。

claude mcp add --scope user duckdb --transport stdio -- uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

claude mcp add --scope user duckdb --transport stdio -- uvx mcp-server-motherduck --db-path /absolute/path/to/db.duckdb

claude mcp add --scope user motherduck --transport stdio --env motherduck_token=YOUR_TOKEN -- uvx mcp-server-motherduck --db-path md: --read-write

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

codex mcp add duckdb -- uvx mcp-server-motherduck --db-path /absolute/path/to/db.duckdb

codex mcp add motherduck --env motherduck_token=YOUR_TOKEN -- uvx mcp-server-motherduck --db-path md: --read-write

gemini mcp add -s user duckdb uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

gemini mcp add -s user duckdb uvx mcp-server-motherduck --db-path /absolute/path/to/db.duckdb

gemini mcp add -s user -e motherduck_token=YOUR_TOKEN motherduck uvx mcp-server-motherduck --db-path md: --read-write

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

{
  "mcpServers": {
    "MotherDuck (local, r/w)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", "md:", "--read-write"],
      "env": {
        "motherduck_token": "<YOUR_MOTHERDUCK_TOKEN>"
      }
    }
  }
}

ツール

*--allow-switch-databasesフラグが必要

すべてのツールはJSONを返します。結果はデフォルトで1024行/50,000文字に制限されます（--max-rows、--max-charsで設定可能）。

本番環境のセキュリティ

セルフホスト型MCPサーバーへの第三者アクセスを許可する場合、読み取り専用モードだけでは不十分です — ローカルファイルシステムへのアクセス、DuckDB設定の変更、その他の潜在的に機密性の高い操作が依然として可能です。

第三者アクセスを伴う本番環境のデプロイメントには、MotherDuckリモートMCP を推奨します — セットアップ不要、読み書き対応、MotherDuckがホストします。

MotherDuck MCPのセルフホスティング: このリポジトリをフォークして必要に応じてカスタマイズしてください。読み取りスケーリングトークン付きのサービスアカウントを使用し、SaaSモードを有効にしてローカルファイルアクセスを制限してください。

DuckDB MCPのセルフホスティング: --init-sqlを使用してセキュリティ設定を適用してください。利用可能なオプションについてはDuckDBセキュリティガイドを参照してください。

Docker

Streamable HTTPを使用してポート8000でサーバーをビルドして実行します（デフォルトはインメモリDuckDB）:

docker build -t mcp-server-motherduck .
docker run --rm -p 8000:8000 mcp-server-motherduck

トークンを渡してコマンドを上書きすることでMotherDuckに接続します:

docker run --rm -p 8000:8000 \
  -e motherduck_token="$MOTHERDUCK_TOKEN" \
  mcp-server-motherduck --transport http --db-path md:

MCPエンドポイントはhttp://localhost:8000/mcpで利用可能です。以下のCLIフラグと環境変数は引き続き適用されます。

コマンドラインパラメータ

環境変数

トラブルシューティング

• spawn uvx ENOENT: uvxへの完全なパスを指定してください（which uvxを実行して検索）
• ファイルがロックされている: --ephemeral-connectionsがオンになっていること（デフォルト: true）と、読み書きモードで接続していないことを確認してください

リソース

• MotherDuck MCPドキュメント
• ループを閉じる: MCP、DuckDB、AIによる高速データパイプライン（ブログ）
• MCPとDuckDBによる高速データパイプライン（YouTube）

開発

ソースから実行する場合:

{
  "mcpServers": {
    "Local DuckDB (Dev)": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-server-motherduck", "run", "mcp-server-motherduck", "--db-path", "md:"],
      "env": {
        "motherduck_token": "<YOUR_MOTHERDUCK_TOKEN>"
      }
    }
  }
}

リリースプロセス

1. Release New Version GitHub Actionを実行
2. MAJOR.MINOR.PATCH形式でバージョンを入力
3. ワークフローがバージョンを更新し、PyPI/MCPレジストリに公開し、MCPBパッケージを含むGitHubリリースを作成

ライセンス

MITライセンス - LICENSEファイルを参照してください。

mcp-name: io.github.motherduckdb/mcp-server-motherduck