PostgreSQL MCP 服务器

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

特征

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

快速入门

# Run the server without a DB connection (useful for Glama or inspection)
python postgres_server.py

# With a live database – pick one method:
export POSTGRES_CONNECTION_STRING="postgresql://user:pass@host:5432/db"
python postgres_server.py

# …or…
python postgres_server.py --conn "postgresql://user:pass@host:5432/db"

# Or using Docker (build once, then run):
# docker build -t mcp-postgres . && docker run -p 8000:8000 mcp-postgres

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 PostgreSQL MCP 服务器：

npx -y @smithery/cli install @gldc/mcp-postgres --client claude

手动安装

克隆此存储库：

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

用法

启动 MCP 服务器。
# Without a connection string (server starts, DB‑backed tools will return a friendly error) python postgres_server.py # Or set the connection string via environment variable: export POSTGRES_CONNECTION_STRING="postgresql://username:password@host:port/database" python postgres_server.py # Or pass it using the --conn flag: python postgres_server.py --conn "postgresql://username:password@host:port/database"
该服务器提供以下工具：

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

使用 Docker 运行

构建图像：

docker build -t mcp-postgres .

在没有数据库连接的情况下运行容器（服务器保持可检查）：

docker run -p 8000:8000 mcp-postgres

通过提供POSTGRES_CONNECTION_STRING使用实时 PostgreSQL 数据库运行：

docker run \
  -e POSTGRES_CONNECTION_STRING="postgresql://username:password@host:5432/database" \
  -p 8000:8000 \
  mcp-postgres

如果省略环境变量，服务器将正常启动，并且所有数据库支持的工具都会返回友好的“未设置连接字符串”消息，直到您提供它。

使用 mcp.json 进行配置

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

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

如果省略了POSTGRES_CONNECTION_STRING ，服务器仍会启动并完全可检查；数据库支持的工具将仅返回信息错误，直到提供该变量。

代替：

/path/to/venv替换为您的虚拟环境路径
/path/to/postgres_server.py包含服务器脚本的绝对路径

安全

切勿在代码中暴露敏感的数据库凭据
使用环境变量或安全配置文件作为数据库连接字符串
考虑使用连接池来更好地管理资源
实施适当的访问控制和用户身份验证

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

MIT 许可证

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

Related MCP Servers

Model Context Protocol PostgreSQL Server
endaoment
-
security
F
license
-
quality
A server that allows AI models to interact with PostgreSQL databases through a standardized protocol, providing database schema information and SQL query execution capabilities.
Last updated -
JavaScript
PostgreSQL MCP Server
HenkDz
-
security
A
license
-
quality
A Model Context Protocol server that enables powerful PostgreSQL database management capabilities including analysis, schema management, data migration, and monitoring through natural language interactions.
Last updated -
355
46
TypeScript
AGPL 3.0
MCP PostgreSQL Server
antonorlov
A
security
A
license
A
quality
Enables AI models to interact with PostgreSQL databases through a standardized interface, supporting operations like queries, table manipulation, and schema inspection.
Last updated -
5
127
2
JavaScript
MIT License
PostgreSQL MCP Server
hthuong09
-
security
F
license
-
quality
A Model Context Protocol server that enables interaction with PostgreSQL databases to list tables, retrieve schemas, and execute read-only SQL queries.
Last updated -
16,948
JavaScript

View all related MCP servers

PostgreSQL MCP Server