PostgreSQL Products MCP Server

PostgreSQL Products MCP サーバー

これは、製品情報を含む PostgreSQL データベースと連携するために設計された Model Context Protocol（MCP）サーバーです。クライアント（AI アシスタントなど）から SQL を使用してデータベースにクエリを実行できます。

前提条件

• Node.js（v18 以降を推奨）
• npm または yarn
• products スキーマを持つ PostgreSQL データベースへのアクセス

インストール

1. このリポジトリをクローンします（またはソースコードをダウンロードします）。

   git clone https://github.com/michael7736/postgres-mcp-server.git
   cd postgres-mcp-server
   

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

   npm install
   # or
   yarn install
   

ビルド

TypeScript コードを JavaScript にコンパイルします。

npm run build
# or
yarn build

これにより、実行可能ファイルが build/ ディレクトリ（build/index.js）に作成されます。

設定

このサーバーでは、MCP クライアントの設定（例：cline_mcp_settings.json または claude_desktop_config.json）で構成する際に、環境変数を使用して PostgreSQL 接続情報を指定する必要があります。

必要な環境変数は次のとおりです。

• PGHOST：PostgreSQL サーバーのホスト名。
• PGPORT：PostgreSQL サーバーのポート番号（デフォルト：5432）。
• PGUSER：データベース接続に使用するユーザー名。
• PGPASSWORD：データベース接続に使用するパスワード。
• PGDATABASE：接続するデータベースの名前。

MCP 設定の例：

{
  "mcpServers": {
    "postgres-products": {
      "command": "node",
      "args": ["/path/to/your/postgres-mcp-server/build/index.js"],
      "env": {
        "PGHOST": "your_db_host",
        "PGPORT": "5432",
        "PGUSER": "your_db_user",
        "PGPASSWORD": "your_db_password",
        "PGDATABASE": "your_db_name"
      },
      "disabled": false, // Ensure it's enabled
      "autoApprove": [] // Configure auto-approval if needed
    }
    // ... other servers
  }
}

/path/to/your/postgres-mcp-server/build/index.js を、お使いのシステム上にあるビルド済みサーバーファイルの実際のパスに置き換え、env セクションにご利用のデータベース認証情報を入力してください。

使用方法

MCP クライアント経由で設定して実行すると、このサーバーは次のツールを提供します。

run_sql_query

設定された製品データベースに対して、読み取り専用の SQL クエリ（SELECT 文のみ）を実行します。

入力スキーマ：

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The SQL SELECT query to execute."
    }
  },
  "required": ["query"]
}

ツール呼び出しの例：

<use_mcp_tool>
  <server_name>postgres-products</server_name>
  <tool_name>run_sql_query</tool_name>
  <arguments>
  {
    "query": "SELECT product_name, stock_quantity FROM products WHERE category = 'Electronics';"
  }
  </arguments>
</use_mcp_tool>