Postgresql Multi Schema

🚀 PostgreSQL 多架構 MCP 服務器

本項目是一個提供只讀訪問 PostgresSQL 數據庫的模型上下文協議 (MCP) 服務器，增強了多架構支持。它能讓大型語言模型 (LLMs) 跨多個命名空間檢查數據庫架構並執行只讀查詢，同時保證架構隔離。

🚀 快速開始

服務器需要一個數據庫 URL，並接受要暴露的架構列表（以逗號分隔）：

npx -y mcp-server-postgres-multi-schema <database-url> [schemas]

• database-url：PostgreSQL 連接字符串 (例如，postgresql://localhost/mydb)
• schemas：要暴露的架構列表，用逗號分隔（默認為 'public' 如果未指定）

示例

# 使用默認公共架構連接
npx -y mcp-server-postgres-multi-schema postgresql://localhost/mydb

# 使用多個架構
npx -y mcp-server-postgres-multi-schema postgresql://localhost/mydb public,analytics,staging

✨ 主要特性

• 多架構支持：可通過命令行配置明確指定要暴露的架構。
• 架構隔離：嚴格控制訪問，僅允許在服務器啟動時列出的授權架構進行訪問。
• 跨架構發現：提供統一的多個架構表視圖，同時維護架構邊界。
• 元數據安全：過濾系統目錄，僅顯示用戶定義的表和指定架構。

📦 安裝指南

暫未提供安裝指南相關內容，可參考上述快速開始部分的啟動命令。

💻 使用示例

基礎用法

在命令行中使用以下命令啟動服務器：

# 使用默認公共架構連接
npx -y mcp-server-postgres-multi-schema postgresql://localhost/mydb

# 使用多個架構
npx -y mcp-server-postgres-multi-schema postgresql://localhost/mydb public,analytics,staging

高級用法

與 Claude Desktop 一起使用時，在 claude_desktop_config.json 中配置 "mcpServers" 部分：

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-postgres-multi-schema",
        "postgresql://localhost/mydb",
        "public,audit"
      ]
    }
  }
}

📚 詳細文檔

組件

工具

• query
  • 執行只讀 SQL 查詢到連接的數據庫。
  • 輸入: sql (字符串)：要執行的 SQL 查詢。
  • 所有查詢都在 READ ONLY 事務中執行。
  • 通過 search_path 限制維護架構上下文。

資源

服務器為每個表提供所授權架構的信息：

• 表架構 (postgres://<host>/<db_schema>/<table>/schema)
  • 每個表的 JSON 架構信息。
  • 包括列名、數據類型和類型修飾符。
  • 自動從數據庫元數據中發現。
  • 多架構支持，帶有顯式架構允許列表。

📄 許可證

此多架構 MCP 服務器根據 MIT 許可證發佈。您可以按照 LICENSE 文件中的條款使用、修改和分發軟件。