Database Analyzer MCP Server

🚀 データベース分析器 MCP サーバー

強力なデータベース分析ツールで、PostgreSQL データベースの内部チェックと分析を行う MCP（モデルコンテキストプロトコル）サーバーインターフェイスを提供します。このツールを使用すると、標準化されたインターフェイスを通じてデータベースのスキーマや関係を探索し、安全なクエリを実行することができます。

✨ 主な機能

• データベーススキーマ分析
  • 指定されたスキーマ内のすべてのテーブルをリストする
  • 特定のテーブルの詳細なスキーマ情報を取得する
  • 列定義、データ型、制約を確認する
• 安全なクエリ実行
  • パラメータ化された入力を持つ安全な SELECT クエリを実行する
  • 承認されていない変更を防止するための組み込みセキュリティ対策がある

📦 インストール

前提条件

• Python 3.x
• PostgreSQL データベース
• 必要な Python パッケージ：
  • mcp（モデルコンテキストプロトコル）
  • 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 インジェクションを防止するためのパラメータ化クエリ
• 機密データには環境変数に基づく設定を使用する
• 自動的な接続クリーンアップとリソース管理

エラー処理

サーバーには包括的なエラー処理が組み込まれており、以下の問題を扱います：

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