PostgreSQL MCP サーバー

鍛冶屋のバッジ

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

バージョン0.2.0

Related MCP server: MCP PostgreSQL Server

特徴

サーバーは次のツールを提供します。

1. データベースの分析とセットアップ

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

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

構成分析
パフォーマンス指標
セキュリティ評価
最適化のための推奨事項

// Example usage
{
  "analysisType": "performance" // Optional: "configuration" | "performance" | "security"
}

1.2. セットアップ手順の取得 ( `get_setup_instructions` )

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

プラットフォーム固有のインストール手順
構成の推奨事項
セキュリティのベストプラクティス
インストール後のタスク

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

1.3. デバッグデータベース ( `debug_database` )

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

接続の問題
パフォーマンスのボトルネック
ロックの競合
レプリケーションステータス

// Example usage
{
  "issue": "performance", // Required: "connection" | "performance" | "locks" | "replication"
  "logLevel": "debug" // Optional: "info" | "debug" | "trace"
}

2. スキーマ管理

2.1. スキーマ情報の取得 ( `get_schema_info` )

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

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

// Example usage
{
  "tableName": "users" // Optional: specific table to get info for
}

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

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

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

// Example usage
{
  "tableName": "users", // Required
  "columns": [ // Required
    { "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()" }
  ]
}

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

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

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

// Example usage
{
  "tableName": "users", // Required
  "operations": [ // Required
    { "type": "add", "columnName": "last_login", "dataType": "TIMESTAMP" },
    { "type": "alter", "columnName": "email", "nullable": false },
    { "type": "drop", "columnName": "temporary_field" }
  ]
}

2.4. 列挙型を取得する ( `get_enums` )

PostgreSQL ENUM 型に関する情報を取得します。

// Example usage
{
  "schema": "public", // Optional
  "enumName": "user_status" // Optional
}

2.5. 列挙型の作成 ( `create_enum` )

データベースに新しい ENUM 型を作成します。

// Example usage
{
  "enumName": "order_status", // Required
  "values": ["pending", "processing", "shipped", "delivered"], // Required
  "schema": "public", // Optional
  "ifNotExists": true // Optional
}

3. データ移行

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

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

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

// Example usage
{
  "tableName": "users", // Required
  "outputPath": "./exports/users.json", // Required
  "where": "created_at > '2023-01-01'", // Optional
  "limit": 1000, // Optional
  "format": "json" // Optional: "json" | "csv"
}

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

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

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

// Example usage
{
  "tableName": "users", // Required
  "inputPath": "./imports/users.json", // Required
  "truncateFirst": false, // Optional
  "format": "json", // Optional: "json" | "csv"
  "delimiter": "," // Optional: for CSV files
}

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

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

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

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

4. 監視

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

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

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

// Example usage
{
  "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
  }
}

5. 機能

5.1. 関数の取得 ( `get_functions` )

PostgreSQL 関数に関する情報を取得します。

// Example usage
{
  "functionName": "calculate_total", // Optional
  "schema": "public" // Optional
}

5.2. 関数の作成 ( `create_function` )

PostgreSQL 関数を作成または置き換えます。

// Example usage
{
  "functionName": "get_user_count", // Required
  "parameters": "", // Required (empty if no params)
  "returnType": "integer", // Required
  "functionBody": "SELECT count(*) FROM users;", // Required
  "language": "sql", // Optional
  "volatility": "STABLE", // Optional
  "schema": "public", // Optional
  "security": "INVOKER", // Optional
  "replace": true // Optional
}

5.3. ドロップ関数（ `drop_function` ）

PostgreSQL 関数を削除します。

// Example usage
{
  "functionName": "old_function", // Required
  "parameters": "integer", // Optional: required for overloaded functions
  "schema": "public", // Optional
  "ifExists": true, // Optional
  "cascade": false // Optional
}

6. 行レベルセキュリティ（RLS）

6.1. RLSを有効にする（ `enable_rls` ）

テーブルで行レベルのセキュリティを有効にします。

// Example usage
{
  "tableName": "sensitive_data", // Required
  "schema": "secure" // Optional
}

6.2. RLSを無効にする（ `disable_rls` ）

テーブルの行レベルセキュリティを無効にします。

// Example usage
{
  "tableName": "sensitive_data", // Required
  "schema": "secure" // Optional
}

6.3. RLSポリシーの作成（ `create_rls_policy` ）

行レベルのセキュリティポリシーを作成します。

// Example usage
{
  "tableName": "documents", // Required
  "policyName": "user_can_see_own_docs", // Required
  "using": "owner_id = current_user_id()", // Required
  "check": "owner_id = current_user_id()", // Optional
  "schema": "public", // Optional
  "command": "SELECT", // Optional
  "role": "app_user", // Optional
  "replace": false // Optional
}

6.4. RLSポリシーの編集（ `edit_rls_policy` ）

既存の行レベルセキュリティポリシーを編集します。

// Example usage
{
  "tableName": "documents", // Required
  "policyName": "user_can_see_own_docs", // Required
  "schema": "public", // Optional
  "roles": ["app_user", "admin_user"], // Optional: New roles (empty or omit to keep existing/use default)
  "using": "owner_id = current_user_id() OR is_admin(current_user_id())", // Optional: New USING expression
  "check": "owner_id = current_user_id()" // Optional: New WITH CHECK expression
}

6.5. RLSポリシーの削除（ `drop_rls_policy` ）

行レベルのセキュリティポリシーを削除します。

// Example usage
{
  "tableName": "documents", // Required
  "policyName": "old_policy", // Required
  "schema": "public", // Optional
  "ifExists": true // Optional
}

6.6. RLSポリシーの取得（ `get_rls_policies` ）

行レベルのセキュリティポリシーを取得します。

// Example usage
{
  "tableName": "documents", // Optional
  "schema": "public" // Optional
}

7. トリガー

7.1. トリガーの取得 ( `get_triggers` )

PostgreSQL トリガーに関する情報を取得します。

// Example usage
{
  "tableName": "audit_log", // Optional
  "schema": "public" // Optional
}

7.2. トリガーの作成 ( `create_trigger` )

PostgreSQL トリガーを作成します。

// Example usage
{
  "triggerName": "log_user_update", // Required
  "tableName": "users", // Required
  "functionName": "audit_user_change", // Required
  "schema": "public", // Optional
  "timing": "AFTER", // Optional
  "events": ["UPDATE"], // Optional
  "when": "OLD.email IS DISTINCT FROM NEW.email", // Optional
  "forEach": "ROW", // Optional
  "replace": false // Optional
}

7.3. ドロップトリガー（ `drop_trigger` ）

PostgreSQL トリガーを削除します。

// Example usage
{
  "triggerName": "old_trigger", // Required
  "tableName": "users", // Required
  "schema": "public", // Optional
  "ifExists": true, // Optional
  "cascade": false // Optional
}

7.4. トリガー状態の設定 ( `set_trigger_state` )

PostgreSQL トリガーを有効または無効にします。

// Example usage
{
  "triggerName": "log_user_update", // Required
  "tableName": "users", // Required
  "enable": false, // Required: true to enable, false to disable
  "schema": "public" // Optional
}

前提条件

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

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の postgresql-mcp-server を自動的にインストールするには:

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

手動インストール

リポジトリをクローンする
依存関係をインストールします:
```
npm install
```
サーバーを構築します。
```
npm run build
```
MCP 設定ファイルに追加します (例: IDE の設定またはグローバル MCP 構成)。
サーバーの接続文字列を構成する方法はいくつかあり、優先順位は次のとおりです。
1. ツール固有の引数: 特定のツールを呼び出すときに、引数でconnectionString直接指定されている場合、その呼び出しにはその値が使用されます。
2. CLI 引数: -csまたは--connection-string引数を使用してサーバーを起動するときに、デフォルトの接続文字列を指定できます。
3. 環境変数: 上記のどちらも指定されていない場合、サーバーはPOSTGRES_CONNECTION_STRING環境変数を探します。
これらのいずれの方法でも接続文字列が見つからない場合、データベース接続を必要とするツールは失敗します。
MCP 設定で CLI 引数を使用する例:
```
{
  "mcpServers": {
    "postgresql-mcp": {
      "command": "node",
      "args": [
        "/path/to/postgresql-mcp-server/build/index.js",
        "--connection-string",
        "postgresql://username:password@server:port/dbname"
        // Optionally, add "--tools-config", "/path/to/your/mcp-tools.json"
      ],
      "disabled": false,
      "alwaysAllow": []
      // Note: 'env' block for POSTGRES_CONNECTION_STRING can still be used as a fallback
      // if --connection-string is not provided in args.
    }
  }
}
```
環境変数を使用する例 (CLI 引数を使用しない場合):
```
{
  "mcpServers": {
    "postgresql-mcp": {
      "command": "node",
      "args": [
        "/path/to/postgresql-mcp-server/build/index.js"
        // Optionally, add "--tools-config", "/path/to/your/mcp-tools.json"
      ],
      "disabled": false,
      "alwaysAllow": [],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://username:password@server:port/dbname"
      }
    }
  }
}
```
--connection-string

ツール構成

サーバーは、外部 JSON 構成ファイルを介して有効になっているツールのフィルタリングをサポートしています。

CLI オプション: -tc <path>または--tools-config <path>を使用して、ツール構成ファイルへのパスを指定します。
ファイル形式: JSON ファイルには、ツール名文字列の配列を保持するenabledToolsキーを持つオブジェクトが含まれている必要があります。
mcp-tools.json
```
{
  "enabledTools": [
    "get_schema_info",
    "analyze_database",
    "export_table_data"
  ]
}
```
行動：
- 構成ファイルが提供され、有効な場合は、リストされているツールのみが有効になります。
- ファイルが提供されていない、無効である、または読み取れない場合は、すべてのツールがデフォルトで有効になります。
- サーバーは、この構成に基づいて有効になっているツールをログに記録します。

発達

npm run dev - ホットリロードで開発サーバーを起動する
npm run lint - ESLint を実行する
npm test - テストを実行する（設定されている場合）

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

接続セキュリティ
- サーバーは、次の優先順位に基づいてデータベース接続文字列を決定します。
  1. ツールの引数で直接提供されるconnectionString 。
  2. --connection-stringサーバーの起動時に使用される CLI 引数。
  3. POSTGRES_CONNECTION_STRING環境変数。
- 接続文字列 (特に資格情報を含むもの) が安全に管理されていることを確認します。
- pg (以前は@vercel/postgres ) 経由の接続プールを使用します。
- 接続文字列を検証します。
- SSL/TLS 接続をサポートします (接続文字列で構成)。
クエリの安全性
- 事前定義された操作を実行し、可能な場合は任意の SQL 実行を回避します。
- SQL インジェクションを防ぐために、該当する場合はパラメータ化されたクエリを使用します。
- 監査のために操作をログに記録します。
認証
- 接続文字列を介して PostgreSQL の認証メカニズムに依存します。
- データベースの認証情報を安全に管理してください。可能な限り、クライアントリクエストに認証情報をハードコードしないでください。サーバー設定時には--connection-string CLI オプションまたはPOSTGRES_CONNECTION_STRING環境変数を使用することをお勧めします。

ベストプラクティス

--connection-string CLI オプションまたはPOSTGRES_CONNECTION_STRING環境変数を使用して、デフォルトのデータベース接続文字列を安全に構成します。
ツールがデフォルト以外のデータベースに接続する必要がある場合は、そのツールの引数でconnectionString直接指定します。
常に、適切な資格情報を持つ安全な接続文字列を使用してください。POSTGRES_CONNECTION_STRING 環境変数を使用して構成することをPOSTGRES_CONNECTION_STRING勧めします。
機密性の高い環境については、運用セキュリティの推奨事項に従ってください。
monitor_databaseツールを使用して、データベースのパフォーマンスを定期的に監視および分析します。
PostgreSQL のバージョンを最新の状態に保ってください。
適切なバックアップ戦略を独自に実装します。
リソース管理を改善するには、接続プールを使用します (内部で処理されます)。
適切なエラー処理とログ記録を実装します。
定期的なセキュリティ監査と更新。

エラー処理

サーバーは次のエラー処理を実装します。

接続失敗
クエリエラー
無効な入力
権限の問題

エラーは標準の MCP エラー形式で返されます。

貢献

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

ライセンス

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

PostgreSQL MCP サーバー

バージョン0.2.0

特徴

1. データベースの分析とセットアップ

1.1. データベースの分析 ( analyze_database )

1.2. セットアップ手順の取得 ( get_setup_instructions )

1.3. デバッグデータベース ( debug_database )

2. スキーマ管理

2.1. スキーマ情報の取得 ( get_schema_info )

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

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

2.4. 列挙型を取得する ( get_enums )

2.5. 列挙型の作成 ( create_enum )

3. データ移行

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

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

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

4. 監視

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

5. 機能

5.1. 関数の取得 ( get_functions )

5.2. 関数の作成 ( create_function )

5.3. ドロップ関数（ drop_function ）