MCP Server Template

🚀 PostgreSQL モデルコンテキストプロトコル（Model Context Protocol）サーバー

このサーバーは、PostgreSQL データベースへの読み取り専用アクセスを提供し、大規模言語モデル（LLMs）がデータベースのスキーマを調査し、読み取り専用のクエリを実行できるようにします。

✨ 主な機能

ツール

• query
  • 接続されたデータベースに対する読み取り専用の SQL クエリを実行します。
  • 入力：sql (文字列)：実行する SQL クエリ
  • すべてのクエリは読み取り専用トランザクションで実行されます。

リソース

このサーバーは、各テーブルのスキーマ情報を提供します。

• テーブルスキーマ (postgres://<host>/<table>/schema)
  • 各テーブルの JSON 形式のスキーマ情報
  • 列名とデータ型を含みます。
  • データベースのメタデータから自動的に検出されます。

🚀 クイックスタート

Claude Desktop との連携方法

このサーバーを Claude Desktop アプリと一緒に使用するには、claude_desktop_config.json ファイルの "mcpServers" セクションに以下の設定を追加してください。

Docker

• macOS で Docker を実行する場合、サーバーがホストネットワーク（例：localhost）で動作しているときは、host.docker.internal を使用してください。
• ユーザー名とパスワードは、PostgreSQL URL を postgresql://user:password@host:port/db-name の形式で追加することができます。

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/postgres", 
        "postgresql://host.docker.internal:5432/mydb"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    }
  }
}

/mydb をご自身のデータベース名に置き換えてください。

💻 使用例

基本的な使用法

上記の設定を claude_desktop_config.json に追加することで、Claude Desktop から PostgreSQL データベースの読み取り専用アクセスが可能になります。

高度な使用法

必要に応じて、ユーザー名やパスワードを含む PostgreSQL URL を適切に設定することで、特定のユーザーとしてのアクセスが可能です。

📦 インストール

Docker でのビルド

docker build -t mcp/postgres -f src/postgres/Dockerfile .

📄 ライセンス

この MCP サーバーは MIT License の下で提供されています。これは、あなたが自由にソフトウェアを使用、修正、配布できることを意味しますが、MIT License の条項に従う必要があります。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。