MCP Postgres Full Access Extended

🚀 PostgreSQL 全アクセス MCP サーバー

PostgreSQL 全アクセス MCP（機械学習プラットフォーム）サーバーは、PostgreSQL データベースに対する完全なアクセスをサポートする強力なツールです。読み取りと書き込み操作を含み、schema の詳細、トランザクションサポート、インデックス情報、外部キーの詳細、行数の推定、テーブルの説明などの高度な機能を提供します。

✨ 主な機能

概要

PostgreSQL 全アクセス MCP（機械学習プラットフォーム）サーバーは、PostgreSQL データベースに対する完全なアクセスをサポートする強力なツールです。読み取りと書き込み操作を含み、schema の詳細、トランザクションサポート、インデックス情報、外部キーの詳細、行数の推定、テーブルの説明などの高度な機能を提供します。

核心機能

• 読み取りと書き込みアクセス：SELECT、INSERT、UPDATE、DELETE などのすべてのデータベース操作をサポートします。
• 拡張型 Schema 詳細：インデックスや外部キー関係を含む詳細なテーブル構造情報を提供します。
• トランザクションサポート：データの整合性を確保するためのタイムアウト機能付きで、明示的なトランザクション制御を可能にします。
• インデックスと外部キー情報：テーブルのインデックスと外部キーの詳細を表示します。
• 行数推定：テーブル内のレコード数の推定値を提供します。
• テーブル説明：各テーブルの詳細な説明情報を含みます。

優位性

公式の PostgreSQL MCP サーバーと比較して、このサーバーは機能がより充実しており、より多くの高度な操作をサポートし、より詳細なデータベースメタデータを提供します。

📦 インストール

Docker を使用した実行

# Docker イメージのビルド
docker build -t mcp-postgres-full-access .

# コンテナの起動
docker run -i --rm mcp-postgres-full-access "postgresql://username:password@host:5432/database"

注意事項

• macOS システムでは、Docker コンテナのネットワークに接続するために、ホスト名の代わりに host.docker.internal を使用してください。

💻 使用例

新しいテーブルの作成とデータの追加

ユーザー: "id、名前、価格、在庫を含む新しい製品テーブルを作成する必要があります"

Claude: データベースを分析してクエリを生成

CREATE TABLE products (
    id SERIAL PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    price DECIMAL(10,2) NOT NULL,
    inventory INTEGER DEFAULT 0
);

ユーザー: 確認後、「1回のみ許可」をクリック

Claude: "製品テーブルを作成しました。サンプルデータを追加しますか？"

ユーザー: "はい、5つのサンプル製品データを追加してください"

Claude: 挿入文を生成して承認を要求 ユーザーが確認後、「1回のみ許可」をクリック

データ分析（読み取り専用操作）

ユーザー: "最も高価な3つの製品は何ですか？"

Claude: 読み取り専用クエリを実行して結果を表示

📚 ドキュメント

セキュリティに関する注意事項

データベースユーザーの権限

⚠️ 重要な注意

制限されたデータベースユーザーを使用し、必要な最小限の権限を付与してください。

-- 例：制限されたユーザーの作成（必要に応じて調整）
CREATE USER claude_user WITH PASSWORD 'secure_password';
GRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_user;
GRANT INSERT, UPDATE, DELETE ON TABLE table1, table2 TO claude_user;
-- 必要に応じて特定の権限を付与

使用上のベストプラクティス

💡 使用上のヒント

1. 常に「1回のみ許可」を使用する：書き込み操作を実行する前に、各コマンドを注意深く確認してください。

• コードを十分に検証していない限り、「常に許可」を選択しないでください。

2. テストデータベースに接続する：初めて使用するときは、テストまたはバックアップデータベースに接続してください。
3. 機密データを慎重に取り扱う：データベース内の機密情報が適切に保護されていることを確認してください。

詳細ガイド

機能モジュール

1. PostgreSQL 全アクセス機能
   • DDL および DML 操作を含む完全な SQL クエリをサポートします。
   • 詳細なクエリ結果と実行計画を提供します。
2. 拡張型 Schema 情報
   • テーブル構造、インデックス、外部キーなどの詳細情報を表示します。
   • データベースドキュメントの自動生成をサポートします。
3. トランザクション制御
   • 明示的なトランザクションの開始とコミットを許可します。
   • 死ロックやその他の同時実行問題を防止するためのタイムアウト機能を設定します。
4. パフォーマンス最適化ツール
   • クエリ実行計画の分析を提供します。
   • テーブルスペースの使用状況とインデックス統計情報を表示します。

インストールと構成

クイックインストール

# Docker で MCP サーバーを起動
docker run -d --name mcp-server -p 5000:5000 mcr.microsoft.com/mssql-tools:latest

構成オプション

• ポートマッピング：デフォルトでは 5000 ポートを使用します。
• 環境変数の構成：

  docker run -e PGPORT=5432 -e PGUSER=username -e PGPASSWORD=password ...
  

使用方法

新しいデータベースの作成

CREATE DATABASE my_database;
\c my_database;  -- 新しいデータベースに切り替える

ユーザーと権限の管理

CREATE USER new_user WITH PASSWORD 'securepass';
GRANT ALL PRIVILEGES ON DATABASE my_database TO new_user;

サンプルクエリ

-- すべての製品とその価格をクエリする
SELECT * FROM products ORDER BY price DESC;

-- 新しいレコードを挿入する
INSERT INTO products (name, price, inventory) VALUES ('New Product', 99.99, 10);

セキュリティとコンプライアンス

データ暗号化

• 転送中の暗号化：すべてのデータベース接続が SSL 暗号化を使用することを確認してください。
• 静止データの暗号化：物理的な盗難から保護するために、保存されているデータを暗号化してください。

監査ログ

• すべてのユーザー操作とクエリ履歴を記録します。
• 機密操作を監視するための監査ポリシーを設定します。

規制への準拠

• GDPR、HIPAA などのデータ保護規制に準拠することを確認してください。
• 定期的にセキュリティ監査と脆弱性スキャンを実施してください。

よくある質問

なぜ拡張型 Schema 情報が必要なのですか？

• 回答：拡張型 Schema 情報は、データベース構造をよりよく理解し、クエリパフォーマンスを最適化し、ドキュメントを生成するのに役立ちます。

大きなトランザクションはどのように処理すればよいですか？

• 解答：長いトランザクションを複数の小さなトランザクションに分割し、定期的にコミットして、ロック問題を回避することをお勧めします。

まとめ

PostgreSQL 全アクセス MCP サーバーは、完全な制御と詳細な情報が必要なデータベース管理シナリオに適した機能豊富なツールです。Docker コンテナ化によるデプロイを通じて、既存の環境に簡単に統合でき、セキュリティとパフォーマンスの最適化を確保します。