Duckdb MCP Server

🚀 DuckDB MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を実装しており、Claude などの AI アシスタントが DuckDB を介して強力なデータ分析を行えるようにします。

🚀 クイックスタート

DuckDB MCP サーバーは、DuckDB（高性能分析データベース）に モデルコンテキストプロトコル (MCP) を介して AI アシスタントを接続します。これにより、AI モデルは以下のことが可能になります。

• 様々なデータソース（CSV、Parquet、JSON など）のデータを直接クエリする
• 複雑な設定なしでクラウドストレージ（S3 など）からデータにアクセスする
• 強力な SQL を使用してデータ分析を実行する
• コンテキストと理解の中でデータの洞察を生成する

✨ 主な機能

• SQL クエリツール：DuckDB の強力な構文を使用して任意の SQL クエリを実行します。
• 複数のデータソースサポート：
  • ローカルファイル（CSV、Parquet、JSON など）
  • S3 バケットとクラウドストレージ
  • SQLite データベース
  • DuckDB がサポートするその他すべてのデータソース
• 自動接続管理：データベースファイルの自動作成と接続処理を行います。
• スマートな認証情報処理：シームレスな AWS/S3 認証情報管理を行います。
• ドキュメントリソース：AI アシスタントが使用するための、組み込みの DuckDB SQL とデータインポートのリファレンスがあります。

📋 要件

• Python 3.10 以上
• MCP 互換のクライアント（Claude Desktop、Cursor、Copilot 付きの VS Code など）

📦 インストール

pip を使用する場合

pip install duckdb-mcp-server

ソースコードからインストールする場合

git clone https://github.com/yourusername/duckdb-mcp-server.git
cd duckdb-mcp-server
pip install -e .

🔧 設定

コマンドラインオプション

duckdb-mcp-server --db-path パス/to/database.db [オプション]

必須パラメータ：

• --db-path - DuckDB データベースファイルのパス

オプションパラメータ：

• --host - バインドアドレスを指定します（デフォルト：::1）
• --port - ポートを指定します（デフォルト：8080）

📄 ライセンス

このプロジェクトは MIT License の下でオープンソース化されています。

🙏 貢献

貢献を歓迎します！自由に Pull Request を送信してください。