MCP Postgres Full Access

🚀 PostgreSQL 全文翻訳説明

このMCP（機械学習プラットフォーム）サーバーは、PostgreSQLデータベースに接続するためのカスタムツールで、読み書き操作をサポートし、強化されたデータベースインタラクション機能を提供します。

✨ 主な機能

1. 強化されたデータベースアクセス

• 読み取りと書き込みのサポート：ユーザーがSELECT、INSERT、UPDATE、DELETE操作を実行できるようにします。
• 権限管理：専用のデータベースユーザーを作成し、適切な権限を付与することで、PostgreSQLデータベースへの安全な接続を確保します。例えば：

-- 制限付きユーザーを作成する（必要に応じて調整）
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;
-- 必要な権限のみを付与する

2. 強化されたデータベースインタラクション

• トランザクションサポート：ユーザーはcommitとrollbackコマンドでトランザクションを管理できます。

# トランザクションをコミットする
commit

# トランザクションをロールバックする
rollback

• インデックス情報：指定されたテーブルのインデックスとそのタイプを表示します。

\di+ table_name

• 外部キー情報：特定のテーブルの外部キー関連を表示します。

\d+ table_name

• 行推定：テーブルのサイズと行数の統計情報を提供します。

# テーブルのサイズと行数の統計
\dt+

• テーブルの説明：テーブルとその列の詳細情報（データ型や制約を含む）を表示します。

\d table_name

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

• 常に「一度のみ許可」オプションを使用し、各書き込み操作の前にSQL文を慎重に確認してください。
  • テーブル名を確認し、列名とデータの正確性を確認します。
  • WHERE句が適切であることを確認し、誤削除や誤更新を避けます。

💻 使用例

示例 1：新しいテーブルを作成してデータを追加する

ユーザー：「id、名前、価格、在庫を含む新しい製品テーブルが必要です。」 Claude：あなたのデータベース要件を分析し、以下のSQL文を生成します。

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

ユーザー：確認後、「一度のみ許可」をクリックします。 Claude：「productsテーブルを作成しました。サンプルデータを追加しますか？」 ユーザー：「はい、5つのサンプル製品を追加してください。」 Claude：INSERT文を生成し、承認を求めます。

示例 2：安全な作業フロー

すべての書き込み操作について、二段階認証を採用します。

1. リクエストの分析：Claudeがあなたの要件に基づいてSQLを準備します。
2. 読み取り操作の自動実行：SELECTクエリのみが直接実行されます。
3. 書き込み操作の処理：
   • Claudeがトランザクション内でSQLを実行し、会話を終了します。
   • ユーザーが結果を確認します。
   • 新しい会話で、ユーザーが「はい」でコミットするか、「いいえ」でロールバックします。

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

• 専用のデータベースユーザーを作成する：スーパーユーザーや管理者アカウントの使用を避けてください。
• テスト環境への接続：初回使用時は、テストまたはバックアップデータベースに接続してください。
• 定期的なバックアップ：広範囲に使用する前に、データベースのバックアップ戦略を設定してください。
• ユーザー権限の制限：必要な操作権限のみを付与してください。

📦 インストール

コンテナのビルドと実行

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

# コンテナを実行する
docker run -i --rm mcp-postgres-full-access "postgresql://username:password@host:5432/database"

macOSの注意事項：host.docker.internalを使用してホストネットワークに接続します。

docker run -i --rm mcp-postgres-full-access "postgresql://username:password@host.docker.internal:5432/database"

📄 ライセンス

このMCPサーバーは、MIT Licenseに基づいて配布されています。

作成者

Syahiid Nur Kamil（(@syahiidkamil）によって作成されました。

Copyright © 2024 Syahiid Nur Kamil. All rights reserved.