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"
}

スキーマ管理

4. スキーマ情報（ `get_schema_info` ）

データベースまたは特定のテーブルの詳細なスキーマ情報を取得します。

データベース内のテーブルのリスト
列の定義
制約（主キー、外部キーなど）
インデックス

// Example usage
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "tableName": "users" // Optional: specific table to get info for
}

5. テーブルの作成 ( `create_table` )

指定された列を持つ新しいテーブルを作成します。

列名と型を定義する
null許容制約を設定する
デフォルト値を設定する

// Example usage
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "tableName": "users",
  "columns": [
    { "name": "id", "type": "SERIAL", "nullable": false },
    { "name": "username", "type": "VARCHAR(100)", "nullable": false },
    { "name": "email", "type": "VARCHAR(255)", "nullable": false },
    { "name": "created_at", "type": "TIMESTAMP", "default": "NOW()" }
  ]
}

6. テーブルの変更 ( `alter_table` )

既存のテーブルを変更します。

新しい列を追加する
列の型または制約を変更する
列をドロップする

// Example usage
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "tableName": "users",
  "operations": [
    { "type": "add", "columnName": "last_login", "dataType": "TIMESTAMP" },
    { "type": "alter", "columnName": "email", "nullable": false },
    { "type": "drop", "columnName": "temporary_field" }
  ]
}

データ移行

7. テーブルデータのエクスポート ( `export_table_data` )

テーブルデータを JSON または CSV 形式でエクスポートします。

WHERE句でデータをフィルタリングする
行数を制限する
出力形式を選択

// Example usage
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "tableName": "users",
  "outputPath": "./exports/users.json",
  "where": "created_at > '2023-01-01'", // Optional
  "limit": 1000, // Optional
  "format": "json" // Optional: "json" | "csv"
}

8. テーブルデータのインポート ( `import_table_data` )

JSON または CSV ファイルからデータをインポートします。

オプションでインポート前にテーブルを切り捨てる
さまざまな形式のサポート
カスタムCSV区切り文字

// Example usage
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "tableName": "users",
  "inputPath": "./imports/users.json",
  "truncateFirst": false, // Optional
  "format": "json", // Optional: "json" | "csv"
  "delimiter": "," // Optional: for CSV files
}

9. データベース間のコピー ( `copy_between_databases` )

2 つの PostgreSQL データベース間でデータをコピーします。

WHERE句でデータをフィルタリングする
オプションでターゲットテーブルを切り捨てる

// Example usage
{
  "sourceConnectionString": "postgresql://user:password@localhost:5432/source_db",
  "targetConnectionString": "postgresql://user:password@localhost:5432/target_db",
  "tableName": "users",
  "where": "active = true", // Optional
  "truncateTarget": false // Optional
}

監視

10. データベースの監視 ( `monitor_database` )

PostgreSQL データベースのリアルタイム監視:

データベースメトリック (接続、キャッシュヒット率など)
テーブルメトリクス（サイズ、行数、デッドタプル）
アクティブクエリ情報
ロック情報
レプリケーションステータス
設定可能なアラート

// Example usage
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "includeTables": true, // Optional
  "includeQueries": true, // Optional
  "includeLocks": true, // Optional
  "includeReplication": false, // Optional
  "alertThresholds": { // Optional
    "connectionPercentage": 80,
    "longRunningQuerySeconds": 30,
    "cacheHitRatio": 0.95,
    "deadTuplesPercentage": 10,
    "vacuumAge": 7
  }
}

前提条件

Node.js >= 18.0.0
PostgreSQL サーバー (ターゲットデータベース操作用)
対象のPostgreSQLインスタンスへのネットワークアクセス

インストール

リポジトリをクローンする
依存関係をインストールします:
npm install
サーバーを構築します。
npm run build
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 - テストを実行する

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

接続セキュリティ
- 接続プールを使用する
- 接続タイムアウトを実装する
- 接続文字列を検証する
- SSL/TLS接続をサポート
クエリの安全性
- SQLクエリを検証する
- 危険な操作を防止
- クエリタイムアウトを実装する
- すべての操作をログに記録します
認証
- 複数の認証方法をサポート
- ロールベースのアクセス制御を実装する
- パスワードポリシーを強制する
- 接続資格情報を安全に管理します

ベストプラクティス

常に適切な資格情報を使用して安全な接続文字列を使用する
機密性の高い環境における本番環境のセキュリティ推奨事項に従う
データベースのパフォーマンスを定期的に監視および分析する
PostgreSQLのバージョンを最新に保つ
適切なバックアップ戦略を実装する
リソース管理を改善するために接続プールを使用する
適切なエラー処理とログ記録を実装する
定期的なセキュリティ監査と更新

エラー処理

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

接続失敗
クエリタイムアウト
認証エラー
権限の問題
リソースの制約

貢献

リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを作成する

ライセンス

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

PostgreSQL MCP Server

Integrations

PostgreSQL MCP サーバー

特徴

データベース分析とデバッグ

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

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

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

スキーマ管理

4. スキーマ情報（ `get_schema_info` ）

5. テーブルの作成 ( `create_table` )

6. テーブルの変更 ( `alter_table` )

データ移行

7. テーブルデータのエクスポート ( `export_table_data` )

8. テーブルデータのインポート ( `import_table_data` )

9. データベース間のコピー ( `copy_between_databases` )

監視

10. データベースの監視 ( `monitor_database` )

前提条件

インストール

発達

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

ベストプラクティス

エラー処理

貢献

ライセンス

Integrations

PostgreSQL MCP サーバー

特徴

データベース分析とデバッグ

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

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

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

スキーマ管理

4. スキーマ情報（ get_schema_info ）

5. テーブルの作成 ( create_table )

6. テーブルの変更 ( alter_table )

データ移行

7. テーブルデータのエクスポート ( export_table_data )

8. テーブルデータのインポート ( import_table_data )

9. データベース間のコピー ( copy_between_databases )

監視

10. データベースの監視 ( monitor_database )

前提条件

インストール

発達

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

ベストプラクティス

エラー処理

貢献

ライセンス

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

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

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

4. スキーマ情報（ `get_schema_info` ）

5. テーブルの作成 ( `create_table` )

6. テーブルの変更 ( `alter_table` )

7. テーブルデータのエクスポート ( `export_table_data` )

8. テーブルデータのインポート ( `import_table_data` )

9. データベース間のコピー ( `copy_between_databases` )

10. データベースの監視 ( `monitor_database` )