PostgreSQL MCP 服务器

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

特征

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

先决条件

Python 3.x
PostgreSQL 数据库服务器
访问 PostgreSQL 数据库

安装

克隆此存储库：

git clone <repository-url>
cd mcp-postgres

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

python -m venv venv
source venv/bin/activate  # On Windows, use: venv\Scripts\activate

安装依赖项：

pip install -r requirements.txt

用法

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

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

该服务器提供以下工具：

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 请求。

执照

MIT 许可证

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

使 AI 代理能够通过模型上下文协议与 PostgreSQL 数据库交互，提供数据库模式探索、表结构检查和 SQL 查询执行功能。

PostgreSQL MCP Server

PostgreSQL MCP 服务器

特征

先决条件

安装

用法

使用 mcp.json 进行配置

安全

贡献

相关项目

执照

Appeared in Searches