mcp-server-duckdb

DuckDB用のモデルコンテキストプロトコル（MCP）サーバー実装。MCPツールを介してデータベースとのインタラクション機能を提供します。LLMで分析してみると興味深いでしょう。DuckDBはローカル分析に適しています。

概要

このサーバーは、モデル コンテキスト プロトコルを介して DuckDB データベースとの対話を可能にし、クエリ、テーブル作成、スキーマ検査などのデータベース操作を可能にします。

コンポーネント

リソース

現在、カスタム リソースは実装されていません。

プロンプト

現在、カスタムプロンプトは実装されていません。

ツール

サーバーは次のデータベース対話ツールを実装します。

• query : DuckDBデータベース上で任意のSQLクエリを実行する

  • 入力: query (文字列) - 有効なDuckDB SQL文

  • 出力: クエリ結果をテキストで表示します (または CREATE/INSERT などの操作の場合は成功メッセージを表示します)

構成

必須パラメータ

• db-path (文字列): DuckDBデータベースファイルへのパス

  • データベースファイルと親ディレクトリが存在しない場合は、サーバーが自動的に作成します。

  • --readonlyが指定されていてデータベースファイルが存在しない場合は、サーバはエラーで起動に失敗します。

オプションパラメータ

• --readonly : サーバーを読み取り専用モードで実行する

  • 説明: このフラグが設定されている場合、サーバーは読み取り専用モードで動作します。これは以下のことを意味します。

    • DuckDB データベースはread_only=Trueで開かれ、書き込み操作が防止されます。

    • 指定されたデータベース ファイルが存在しない場合は作成されません。

    • セキュリティ上の利点: 言語モデル (LLM) による書き込み操作の実行を防ぎ、データベースが変更されないようにします。

  • 参考：DuckDB の読み取り専用接続の詳細については、 DuckDB Python API ドキュメントを参照してください。

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の DuckDB サーバーを自動的にインストールするには:

クロードデスクトップ統合

Claude Desktop の構成ファイルで MCP サーバーを構成します。

macOS

場所: ~/Library/Application Support/Claude/claude_desktop_config.json

ウィンドウズ

場所: %APPDATA%/Claude/claude_desktop_config.json

• 注意: ~/mcp-server-duckdb/data/data.db DuckDB データベース ファイルへの実際のパスに置き換える必要があります。

発達

前提条件

• uvパッケージ マネージャーを使用した Python

• DuckDB Python パッケージ

• MCP サーバーの依存関係

デバッグ

MCPサーバーのデバッグは、stdioベースの通信のため困難になる場合があります。最適なデバッグエクスペリエンスを得るには、 MCP Inspectorのご利用をお勧めします。

MCPインスペクターの使用

1. npm を使用してインスペクターをインストールします。

2. 提供されたURLをブラウザで開き、デバッグインターフェースにアクセスします。

インスペクターは次の情報を可視化します。

• リクエスト/レスポンス通信

• ツールの実行

• サーバーの状態

• エラーメッセージ