PostgreSQL MCP サーバー

PostgreSQLデータベース管理機能を提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、既存のPostgreSQL設定の分析、実装ガイダンスの提供、データベースの問題のデバッグを支援します。

特徴

1. データベース分析 ( analyze_database )

PostgreSQL データベースの構成とパフォーマンス メトリックを分析します。

• 構成分析

• パフォーマンスメトリック

• セキュリティ評価

• 最適化のための推奨事項

// Example usage
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "analysisType": "performance" // Optional: "configuration" | "performance" | "security"
}

2. セットアップ手順（ get_setup_instructions ）

PostgreSQL のインストールと構成に関するステップバイステップのガイダンスを提供します。

• プラットフォーム固有のインストール手順

• 構成の推奨事項

• セキュリティのベストプラクティス

• インストール後のタスク

// Example usage
{
  "platform": "linux", // Required: "linux" | "macos" | "windows"
  "version": "15", // Optional: PostgreSQL version
  "useCase": "production" // Optional: "development" | "production"
}

3. データベースのデバッグ（ debug_database ）

一般的な PostgreSQL の問題をデバッグする:

• 接続の問題

• パフォーマンスのボトルネック

• ロックの競合

• レプリケーションステータス

// Example usage
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "issue": "performance", // Required: "connection" | "performance" | "locks" | "replication"
  "logLevel": "debug" // Optional: "info" | "debug" | "trace"
}

Related MCP server: Postgres MCP Pro

前提条件

• Node.js >= 18.0.0

• PostgreSQL サーバー (ターゲット データベース操作用)

• 対象のPostgreSQLインスタンスへのネットワークアクセス

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の PostgreSQL MCP サーバーを自動的にインストールするには:

npx -y @smithery/cli install @nahmanmate/postgresql-mcp-server --client claude

手動インストール

1. リポジトリをクローンする

2. 依存関係をインストールします:

   npm install

3. サーバーを構築します。

   npm run build

4. MCP 設定ファイルに追加:

   {
     "mcpServers": {
       "postgresql-mcp": {
         "command": "node",
         "args": ["/path/to/postgresql-mcp-server/build/index.js"],
         "disabled": false,
         "alwaysAllow": []
       }
     }
   }

発達

• npm run dev - ホットリロードで開発サーバーを起動する

• npm run lint - ESLint を実行する

• npm test - テストを実行する

セキュリティに関する考慮事項

1. 接続セキュリティ

   • 接続プールを使用する

   • 接続タイムアウトを実装する

   • 接続文字列を検証する

   • SSL/TLS接続をサポート

2. クエリの安全性

   • SQLクエリを検証する

   • 危険な操作を防止

   • クエリタイムアウトを実装する

   • すべての操作をログに記録します

3. 認証

   • 複数の認証方法をサポート

   • ロールベースのアクセス制御を実装する

   • パスワードポリシーを強制する

   • 接続資格情報を安全に管理します

ベストプラクティス

1. 常に適切な資格情報を使用して安全な接続文字列を使用する

2. 機密性の高い環境における本番環境のセキュリティ推奨事項に従う

3. データベースのパフォーマンスを定期的に監視および分析する

4. PostgreSQLのバージョンを最新に保つ

5. 適切なバックアップ戦略を実装する

6. リソース管理を改善するために接続プールを使用する

7. 適切なエラー処理とログ記録を実装する

8. 定期的なセキュリティ監査と更新

エラー処理

サーバーは包括的なエラー処理を実装します。

• 接続失敗

• クエリタイムアウト

• 認証エラー

• 権限の問題

• リソースの制約

評価とテストの実行

evals パッケージは mcp クライアントをロードし、index.ts ファイルを実行するため、テスト間で再構築する必要はありません。完全なドキュメントはこちら でご覧いただけます。

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更をコミットする

4. ブランチにプッシュする

5. プルリクエストを作成する

ライセンス

このプロジェクトは AGPLv3 ライセンスの下でライセンスされています - 詳細については LICENSE ファイルを参照してください。