Database Analyzer MCP Server

Database Analyzer MCP Server

PostgreSQL データベースのイントロスペクションと分析を行うための MCP（Model Context Protocol）サーバーインターフェースを提供する、強力なデータベース分析ツールです。このツールを使用すると、標準化されたインターフェースを通じてデータベースのスキーマやリレーションシップを調べ、安全なクエリを実行できます。

機能

• データベーススキーマ分析

  • 指定したスキーマ内のすべてのテーブルを一覧表示します
  • 特定のテーブルの詳細なスキーマ情報を取得します
  • カラム定義、データ型、制約を確認します

• 安全なクエリ実行

  • パラメーター化された入力で SELECT クエリを実行します
  • 不正な変更を防ぐセキュリティ対策が組み込まれています

前提条件

• Python 3.x
• PostgreSQL データベース
• 必要な Python パッケージ：
  • mcp（Model Context Protocol）
  • psycopg2（PostgreSQL アダプター）
  • python-dotenv（環境変数管理）

インストール

1. リポジトリをクローンします：

git clone <repository-url>
cd MCP-server-demo

2. 必要なパッケージをインストールします：

pip install -r requirements.txt

3. データベースの認証情報を記載した .env ファイルをプロジェクトのルートに作成します：

POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_DB=your_database_name
POSTGRES_USER=your_username
POSTGRES_PASSWORD=your_password

使い方

1. MCP サーバーを起動します：

python server.py

2. サーバーでは次のツールを利用できます：

セキュリティ機能

• セキュリティ上の理由から、SELECT クエリのみ実行できます
• SQL インジェクションを防ぐためのパラメーター化クエリ
• 機密データの環境変数ベースの設定
• 接続の自動クリーンアップとリソース管理

エラー処理

サーバーには、次の項目に対応する包括的なエラー処理が備わっています：

• データベース接続の問題
• 無効なクエリ
• スキーマへのアクセスに関する問題
• リソースのクリーンアップ