MCP Server Motherduck

🚀 母鴨MCPサーバー日本語ドキュメント

このドキュメントは、母鴨MCPサーバーのインストール、設定、使用方法について説明します。

🚀 クイックスタート

このセクションでは、Claude DesktopとVS Codeを使用して母鴨MCPサーバーを設定する方法を説明します。

📦 インストール

Claude Desktopを使用する場合

1. まだインストールされていない場合は、claude.ai/downloadからClaude Desktopをダウンロードしてインストールしてください。

2. Claude Desktopの設定ファイルを開きます。

   • 初回使用時は、Claude Desktopアプリケーション内で直接開くことができます。「設定」を選択し、「開発者」タブに移動し、「設定を編集」ボタンをクリックします。
   • claude_desktop_config.jsonファイルに次の設定を追加します。

{
  "mcpServers": {
    "mcp-server-motherduck": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        "md:",
        "--motherduck-token",
        "<YOUR_MOTHERDUCK_TOKEN_HERE>"
      ]
    }
  }
}

⚠️ 重要提示

• <YOUR_MOTHERDUCK_TOKEN_HERE>を実際のMotherDuckトークンに置き換えてください。
• 必要に応じて--home-dirパラメータを設定してください（例：--home-dir /Users/your_username）。

VS Codeを使用する場合

.vscode/mcp.jsonファイルに次の設定を追加するか、この内容をワークスペースのmcp.jsonファイルに直接コピーします。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "motherduck_token",
      "description": "MotherDuckトークン",
      "password": true
    }
  ],
  "servers": {
    "motherduck": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        "md:",
        "--motherduck-token",
        "${input:motherduck_token}"
      ]
    }
  }
}

💻 使用例

基本的な使用法

設定が完了したら、Claudeに次の操作を実行させることができます。

• 「MotherDuck内で新しいデータベースとテーブルを作成する」
• 「ローカルのCSVファイルからデータをクエリする」
• 「ローカルのDuckDBデータベース内のデータをMotherDuck内のテーブルと結合する」
• 「Amazon S3に保存されているデータを分析する」

高度な使用法

デフォルトのMotherDuckデータベースに接続する場合

デフォルトのMotherDuckデータベースに接続するには、--motherduck-tokenパラメータを使用してトークンを指定します。

uvx mcp-server-motherduck --db-path md: --motherduck-token <your_motherduck_token>

指定したMotherDuckデータベースに接続する場合

uvx mcp-server-motherduck --db-path md:your_database_name --motherduck-token <your_motherduck_token>

ローカルのDuckDBデータベースに接続する場合

uvx mcp-server-motherduck --db-path /path/to/your/local.db

メモリデータベースに接続する場合

uvx mcp-server-motherduck --db-path :memory:

データベースパスが指定されていないがmotherduck_token環境変数が設定されている場合、サーバーは自動的にデフォルトのMotherDuckデータベース（md:）に接続します。

SSEモードで実行する場合

サーバーをSSEモードで実行するには、supergatewayツールを使用します。

npx -y supergateway --stdio "uvx mcp-server-motherduck --db-path md: --motherduck-token <your_motherduck_token>"

🔧 トラブルシューティング

注意事項

1. すべての依存関係が正しくインストールされていることを確認してください。
2. コマンドの構文が正しいことを確認してください。
3. spawn uvx ENOENTエラーが発生した場合は、uvxツールが正しくインストールされており、システムパスに含まれていることを確認してください。

📄 ライセンス

このプロジェクトはMITライセンスに準拠しています。詳細については、MIT Licenseを参照してください。