PostgreSQL MCP 服务器

这是一个使用 模型上下文协议 (MCP) Python SDK 实现的 PostgreSQL MCP 服务器。模型上下文协议是一个开放协议，旨在实现 LLM 应用和外部数据源之间的无缝集成。此服务器允许 AI 代理通过标准化接口与 PostgreSQL 数据库进行交互。

功能

• 列出数据库模式
• 列出模式中的表
• 描述表结构
• 列出表约束和关系
• 获取外键信息
• 执行 SQL 查询

前提条件

• Python 3.x
• PostgreSQL 数据库服务器
• 访问 PostgreSQL 数据库的权限

安装

1. 克隆此仓库：

git clone <repository-url>
cd mcp-postgres

2. 创建并激活虚拟环境（推荐）：

python -m venv venv
source venv/bin/activate  # 在 Windows 上，使用：venv\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

用法

1. 通过提供您的 PostgreSQL 连接字符串来启动 MCP 服务器：

python postgres_server.py "postgresql://username:password@host:port/database"

2. 该服务器提供以下工具：

• query: 对数据库执行 SQL 查询
• list_schemas: 列出所有可用的模式
• list_tables: 列出特定模式中的所有表
• describe_table: 获取有关表结构的详细信息
• get_foreign_keys: 获取表的外键关系
• find_relationships: 发现表的显式和隐式关系

使用 mcp.json 进行配置

要将此服务器与 MCP 兼容的工具（如 Cursor）集成，请将其添加到您的 ~/.cursor/mcp.json：

{
  "servers": {
    "postgres": {
      "command": "/path/to/venv/bin/python",
      "args": [
        "/path/to/postgres_server.py",
        "postgresql://username:password@host:5432/database?ssl=true"
      ]
    }
  }
}

替换：

• /path/to/venv 为您的虚拟环境路径
• /path/to/postgres_server.py 为服务器脚本的绝对路径
• 连接字符串为您的 PostgreSQL 数据库凭据

注意：请务必妥善保护您的 mcp.json 文件，因为它包含敏感的数据库凭据。

安全

• 永远不要在您的代码中暴露敏感的数据库凭据
• 使用环境变量或安全配置文件来存储数据库连接字符串
• 考虑使用连接池以获得更好的资源管理
• 实施适当的访问控制和用户身份验证

贡献

欢迎贡献！请随时提交 Pull Request。

相关项目

• MCP 规范
• MCP Python SDK
• MCP 服务器

许可证

MIT 许可证

版权所有 (c) 2025 gldc

特此授予任何人免费获得本软件及其相关文档文件（“软件”）副本的许可，不受限制地处理本软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利，并允许向其提供本软件的人员这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何形式的明示或暗示的保证，包括但不限于适销性、特定用途适用性和不侵权的保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论是在合同、侵权或其他方面，由本软件或本软件的使用或其他交易引起的、与之相关的或与之相关的。