【亲测免费】 Postgres MCP Pro 使用教程

1. 项目介绍

Postgres MCP Pro 是一个开源的 Model Context Protocol (MCP) 服务器，旨在在整个开发过程中支持开发者和 AI 代理。它不仅提供了一个数据库连接包装器，还提供了数据库健康监测、索引优化、模式智能和受保护执行等功能。Postgres MCP Pro 支持标准输入/输出 (stdio) 和服务器发送事件 (SSE) 传输，适用于不同的环境。

2. 项目快速启动

环境准备

在开始之前，请确保您具备以下条件：

• 数据库访问凭证。
• Docker 或 Python 3.12 或更高版本。

使用 Docker 启动

1. 拉取 Postgres MCP Pro 的 Docker 镜像：

   docker pull crystaldba/postgres-mcp
   

2. 运行容器：

   docker run -i --rm -e DATABASE_URI="postgresql://username:password@localhost:5432/dbname" crystaldba/postgres-mcp --access-mode=unrestricted
   

   替换 postgresql://username:password@localhost:5432/dbname 为您的数据库连接 URI。

使用 Python 启动

1. 安装 Postgres MCP Pro：

   如果您已安装 pipx，可以使用以下命令：

   pipx install postgres-mcp
   

   或者使用 uv：

   uv pip install postgres-mcp
   

2. 运行 Postgres MCP Pro：

   postgres-mcp --access-mode=unrestricted
   

   同样，替换 postgresql://username:password@localhost:5432/dbname 为您的数据库连接 URI。

3. 应用案例和最佳实践

优化性能

假设您使用 AI 助手生成了一款电影应用，但 SQLAlchemy ORM 代码运行缓慢。使用 Postgres MCP Pro 和 Cursor AI 代理，您可以在几分钟内解决性能问题。

• 修复性能问题，包括 ORM 查询、索引和缓存。
• 修复需要连接数据到代码的 bug。
• 通过单一提示添加新功能。

安全执行

Postgres MCP Pro 提供了两种访问模式：

• 无限制模式：允许完整的读写访问，适合开发环境。
• 限制模式：限制操作为只读事务，并对资源利用率施加约束（目前仅限执行时间），适合生产环境。

根据您的需求选择适当的模式。

4. 典型生态项目

Postgres MCP Pro 可以与多种 MCP 客户端配合使用，例如 Claude Desktop、Cursor 和 Windsurf。这些客户端通常具有类似的配置文件，您可以参考项目文档进行配置。

以上就是 Postgres MCP Pro 的使用教程，希望能够帮助您更好地利用这个强大的工具。