hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Supports integration with FastAPI for running the MCP server, providing both standalone and integrated deployment options
Provides database access capabilities for MySQL, supporting query execution and schema exploration
Enables querying and interacting with PostgreSQL databases through SQL execution tools and schema resources

データベース MCP サーバー (Legion AI 製)

Model Context Protocol (MCP) Python SDK を統合した Legion Query Runner を使用して、データベース内のデータにアクセスし、クエリを実行できるようにするサーバーです。

特徴

Legion Query Runner 経由のデータベースアクセス
AIアシスタント向けモデルコンテキストプロトコル（MCP）のサポート
データベース操作を MCP リソース、ツール、プロンプトとして公開する
複数の展開オプション（スタンドアロン MCP サーバー、FastAPI 統合）
クエリの実行と結果の処理
環境変数、コマンドライン引数、またはMCP設定JSONによる柔軟な構成

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

データベース	DB_TYPEコード
PostgreSQL	ページ
赤方偏移	赤方偏移
コックローチDB	ゴキブリ
MySQL	MySQL
RDS MySQL	rds_mysql
マイクロソフトSQLサーバー	mssql
ビッグクエリ	ビッグクエリ
オラクルDB	オラクル
SQLite	sqlite

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

MCPとは何ですか?

モデルコンテキストプロトコル（MCP）は、AIアプリケーションにおけるコンテキストを維持するための仕様です。このサーバーは、 MCP Python SDKを使用して以下の機能を実現します。

データベース操作をAIアシスタントのツールとして公開する
データベーススキーマとメタデータをリソースとして提供する
データベース操作に役立つプロンプトを生成する
データベースとのステートフルなインタラクションを可能にする

インストールと設定

必須パラメータ

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

DB_TYPE : データベースタイプコード（上記の表を参照）
DB_CONFIG : データベース接続用のJSON構成文字列

DB_CONFIG の形式はデータベースの種類によって異なります。データベース固有の設定の詳細については、 API ドキュメントを参照してください。

インストール方法

オプション1: UVを使用する（推奨）

uvを使用する場合、特別なインストールは必要ありません。 uvxを使用してdatabase-mcpを直接実行します。

UV設定例:

REPLACE DB_TYPE and DB_CONFIG with your connection info.
{
    "mcpServers": {
      "database-mcp": {
        "command": "uvx",
        "args": [
          "database-mcp"
        ],
        "env": {
          "DB_TYPE": "pg",
          "DB_CONFIG": "{\"host\":\"localhost\",\"port\":5432,\"user\":\"user\",\"password\":\"pw\",\"dbname\":\"dbname\"}"
        },
        "disabled": true,
        "autoApprove": []
      }
    }
}

オプション2: PIPを使用する

pip 経由でインストール:

pip install database-mcp

PIP 構成例:

{
  "mcpServers": {
    "database": {
      "command": "python",
      "args": [
        "-m", "database_mcp", 
        "--repository", "path/to/git/repo"
      ],
      "env": {
        "DB_TYPE": "pg",
        "DB_CONFIG": "{\"host\":\"localhost\",\"port\":5432,\"user\":\"user\",\"password\":\"pw\",\"dbname\":\"dbname\"}"
      }
    }
  }
}

サーバーの実行

開発モード

mcp dev mcp_server.py

生産モード

python mcp_server.py

設定方法

環境変数

export DB_TYPE="pg"  # or mysql, postgresql, etc.
export DB_CONFIG='{"host":"localhost","port":5432,"user":"username","password":"password","dbname":"database_name"}'
mcp dev mcp_server.py

コマンドライン引数

python mcp_server.py --db-type pg --db-config '{"host":"localhost","port":5432,"user":"username","password":"password","dbname":"database_name"}'

またはUVの場合:

uv mcp_server.py --db-type pg --db-config '{"host":"localhost","port":5432,"user":"username","password":"password","dbname":"database_name"}'

公開されたMCP機能

リソース

リソース	説明
`schema://all`	完全なデータベーススキーマを取得する

ツール

道具	説明
`execute_query`	SQLクエリを実行し、結果をマークダウンテーブルとして返す
`execute_query_json`	SQLクエリを実行し、結果をJSONとして返す
`get_table_columns`	特定のテーブルの列名を取得する
`get_table_types`	特定のテーブルの列タイプを取得する
`get_query_history`	最近のクエリ履歴を取得する

プロンプト

プロンプト	説明
`sql_query`	データベースに対してSQLクエリを作成する
`explain_query`	SQLクエリが何をするのかを説明する
`optimize_query`	パフォーマンス向上のためにSQLクエリを最適化する

発達

テスト

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

出版

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

ライセンス

このリポジトリはGPLライセンスです

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

モデルコンテキストプロトコル（MCP）Python SDKを統合したクエリランナーを使用して、データベース内のデータにアクセスし、クエリを実行できるサーバーです。PostgreSQL、Redshift、MySQL、Microsoft SQL Server、Google API、Amazon Web Services（boto3経由）、CockroachDB、SQLiteなどのデータベースをサポートしています。

Appeared in Searches

An Overview of Microsoft SQL Server