MCP Pg Schema

🚀 PostgreSQL 模型上下文協議服務器

本服務器基於模型上下文協議（Model Context Protocol），可提供對 PostgreSQL 數據庫的只讀訪問服務。藉助該服務器，大型語言模型（LLM）能夠檢查數據庫架構，並執行只讀查詢操作。

🚀 快速開始

要將此服務器與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替換為您的數據庫名稱。

✨ 主要特性

工具

• query
  • 可針對已連接的數據庫執行只讀 SQL 查詢。
  • 輸入參數：sql (字符串)，即要執行的 SQL 查詢語句。
  • 所有查詢均在只讀事務中執行。

資源

服務器會為每個數據庫表提供架構信息：

• 表架構 (postgres://<host>/<table>/schema)
  • 提供每個表的 JSON 架構信息。
  • 包含列名和數據類型。
  • 該信息會自動從數據庫元數據中發現。

📦 安裝指南

Docker 構建

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

📄 許可證

此 MCP 服務器遵循 MIT 許可證發佈。您可以自由使用、修改和分發該軟件，但需遵守 MIT 許可證的相關條款和條件。更多詳細信息，請查閱項目存儲庫中的 LICENSE 文件。