🚀 PostgreSQL 多模式 MCP 服务器

这是一个模型上下文协议（Model Context Protocol）服务器，可提供对 PostgreSQL 数据库的只读访问，具备强大的多模式支持能力。该服务器能让大型语言模型（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

✨ 主要特性

• 多模式支持：可通过命令行配置明确指定要暴露哪些架构。
• 架构隔离：具备严格的访问控制，仅允许访问在服务器启动时列出的授权架构。
• 跨模式发现：能提供多个架构表的一致视图，同时保持架构边界。
• 元数据安全：会筛选系统目录，仅显示指定架构中的用户定义表。

📚 详细文档

组件

工具

• 查询
  • 可执行只读 SQL 查询到连接的数据库。
  • 输入：sql（字符串）：要执行的 SQL 查询。
  • 所有查询都在 READ ONLY 事务中执行。
  • 通过搜索路径限制维护架构上下文。

资源

该服务器为每个表提供授权架构中的模式信息：

• 表格模式 (postgres://<host>/<db_schema>/<table>/schema)
  • 提供每个表的 JSON 模式信息。
  • 包括列名、数据类型和类型修饰符。
  • 自动从数据库元数据中发现。
  • 支持多架构，带有明确的架构允许列表。

与 Claude Desktop 配置一起使用

在你的 claude_desktop_config.json 中配置 "mcpServers" 部分：

NPX

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

📄 许可证

该多架构 MCP 服务器根据 MIT 许可证发布。你可以按照 LICENSE 文件中所述的条款使用、修改和分发软件。