Postgresql Products MCP Server

🚀 PostgreSQL 製品 MCP サーバー

このサーバーは、Model Context Protocol (MCP) に基づいており、製品情報を含む PostgreSQL データベースとのやり取りを可能にします。クライアント（例：AI アシスタント）が SQL を使用してデータベースをクエリできるようになっています。

🚀 クイックスタート

このサーバーを使用する前に、いくつかの前提条件を満たす必要があります。また、インストール、ビルド、設定の手順を踏むことで、サーバーを使用できるようになります。

✨ 主な機能

• クライアントが SQL を使用して PostgreSQL データベースをクエリできる。
• 設定された製品データベースに対して読み取り専用の 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
   # または
   yarn install
   

🔧 ビルド

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

npm run build
# または
yarn build

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

📚 ドキュメント

設定

このサーバーは、PostgreSQL の接続詳細を環境変数で提供する必要があります。これらの情報は、MCP クライアント設定（例：cline_mcp_settings.json または claude_desktop_config.json）で使用されます。

必要な環境変数は以下の通りです：

• 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, // 有効にすることを確認
      "autoApprove": [] // 必要に応じて自動承認を設定
    }
    // ... 他のサーバー
  }
}

/path/to/your/postgres-mcp-server/build/index.js を、実際のビルドファイルのパスに置き換え、env セクションに具体的なデータベース資格情報を入力してください。

使用方法

設定が完了し、MCP クライアントを介してこのサーバーを実行すると、以下のツールが提供されます。

💻 使用例

基本的な使用法

run_sql_query ツールを使用して、設定された製品データベースに対して読み取り専用の SQL クエリ（SELECT ステートメントのみ）を実行できます。

入力形式：

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "実行する SQL 選択クエリ。"
    }
  },
  "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>