Legion Database

🚀 データベース MCP サーバー（Legion AI 提供）

このサーバーは、データベースのデータへのアクセスとクエリの実行を支援し、Legion Query Runner と Model Context Protocol (MCP) Python SDK を統合するためのものです。

🚀 クイックスタート

このデータベース MCP サーバーを使用することで、Legion Query Runner を通じて様々なデータベースにアクセスし、MCP を利用したデータベース操作を行うことができます。

✨ 主な機能

• Legion Query Runner を使用したデータベースへのアクセス
• Model Context Protocol (MCP) のサポート
• データベース操作を MCP のリソース、ツール、ヒントとして公開
• 複数のデプロイオプション（独立した MCP サーバー、FastAPI 統合）
• クエリの実行と結果の処理
• 環境変数、コマンドライン引数、または MCP 設定 JSON による柔軟な設定方法

📦 インストール

必要パラメータ

すべてのインストール方法で、以下の 2 つのパラメータが必要です。

• DB_TYPE：データベースタイプのコード（下記の表を参照）
• DB_CONFIG：データベースの設定情報

インストール方法

UV を使用したインストール

uv pip install package_name

PIP を使用したインストール

pip install package_name

💻 使用例

基本的な使用法

サーバーの起動（開発モード）

uv config.yaml

サーバーの起動（本番モード）

python -m module_name

高度な使用法

環境変数による設定

export DB_TYPE="pg"
export DB_CONFIG="your_config_here"

コマンドライン引数による設定

--db_type pg --db_config "your_config_here"

📚 ドキュメント

サポートされるデータベース

Legion Query Runner ライブラリをコネクタとして使用しています。詳細は API ドキュメント を参照してください。

什么是 MCP？

Model Context Protocol (MCP) は、AI アプリケーションでコンテキストを維持するための規格です。このサーバーは MCP Python SDK を使用して、以下のことを行います。

• データベース操作を AI アシスタントのツールとして公開
• データベースのスキーマとメタデータをリソースとして提供
• データベース操作を実行するための有用なヒントを生成
• データベースとの状態のやり取りを有効にする

MCP 機能

リソース

• クエリの実行：execute_query
• JSON 結果の返却：execute_query_json
• テーブルの列名の取得：get_table_columns
• 列の型の取得：get_table_types
• クエリ履歴の取得：get_query_history

ツール

• SQL クエリの生成：sql_query
• SQL クエリの説明：explain_query
• SQL クエリの最適化：optimize_query

開発

テスト

uv pip install -e ".[dev]" && pytest

リリース

rm -rf dist/ build/ *.egg-info/ && python -m build
python -m build
python -m twine upload dist/*

📄 ライセンス

このリポジトリは GPL ライセンスで提供されています。