crystaldba/postgres-mcp

一个支持索引调优、执行计划（Explain Plans）、健康检查和安全 SQL 执行的 Postgres MCP 服务器。

概览 • 演示 • 快速开始 • 技术说明 • MCP API • 相关项目 • 常见问题

概览

Postgres MCP Pro 是一个开源的 Model Context Protocol (MCP) 服务器，旨在为您和您的 AI Agent 提供全开发流程的支持——从最初的代码编写、测试、部署，到生产环境的调优与维护。

Postgres MCP Pro 不仅仅是对数据库连接的封装，其功能包括：

• 🔍 数据库健康状况 - 分析索引健康、连接利用率、缓冲区缓存、Vacuum 健康状况、序列限制、复制延迟等。
• ⚡ 索引调优 - 利用工业级算法，探索成千上万种潜在索引方案，为您的业务负载寻找最佳解决方案。
• 📈 查询计划 - 通过检查 EXPLAIN 计划并模拟假设索引的影响，验证并优化性能。
• 🧠 模式智能 (Schema Intelligence) - 基于对数据库模式（Schema）的深入理解，提供上下文感知的 SQL 生成。
• 🛡️ 安全 SQL 执行 - 提供可配置的访问控制，包括只读模式和安全 SQL 解析，使其既适用于开发环境，也适用于生产环境。

Postgres MCP Pro 同时支持 标准输入/输出 (stdio) 和 服务器发送事件 (SSE) 传输协议，以适应不同的环境需求。

关于我们构建 Postgres MCP Pro 的初衷，请参阅 我们的发布博文。

演示

从无法使用到速度飞跃

• 挑战： 我们使用 AI 助手生成了一个电影应用程序，但其中的 SQLAlchemy ORM 代码运行极其缓慢。
• 解决方案： 通过在 Cursor 中使用 Postgres MCP Pro，我们在几分钟内就修复了性能问题。

我们的工作包括：

• 🚀 性能修复 - 包括 ORM 查询、索引建立和缓存优化。
• 🛠️ 页面修复 - 通过提示 Agent 探索数据、修复查询并添加相关内容。
• 🧠 改进推荐列表 - 通过分析数据并优化 ORM 查询，呈现更相关的结果。

请观看下方的视频或阅读 详细操作步骤。

https://github.com/user-attachments/assets/24e05745-65e9-4998-b877-a368f1eadc13

快速开始

前置条件

在开始之前，请确保您已具备：

1. 数据库的访问凭据。
2. Docker 或 Python 3.12 及以上版本。

访问凭据

您可以使用 psql 或 pgAdmin 等 GUI 工具验证您的访问凭据是否有效。

Docker 或 Python

您可以自由选择使用 Docker 或 Python。 我们通常推荐使用 Docker，因为 Python 用户可能会遇到更多与环境相关的问题。当然，选择您最熟悉的方式即可。

安装

选择以下任一方法来安装 Postgres MCP Pro：

选项 1：使用 Docker

拉取 Postgres MCP Pro 的 Docker 镜像。该镜像包含所有必要的依赖项，为您在不同环境中运行 Postgres MCP Pro 提供了一种可靠的方式。

docker pull crystaldba/postgres-mcp

选项 2：使用 Python

如果您安装了 pipx，可以通过以下命令安装：

pipx install postgres-mcp

否则，请使用 uv 进行安装：

uv pip install postgres-mcp

如果需要安装 uv，请参考 uv 安装指南。

配置您的 AI 助手

我们提供了将 Postgres MCP Pro 配置到 Claude Desktop 的完整指南。许多 MCP 客户端具有相似的配置文件，您可以根据所选客户端调整这些步骤。

Claude Desktop 配置

您需要编辑 Claude Desktop 的配置文件以添加 Postgres MCP Pro。该文件的位置取决于您的操作系统：

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

您也可以使用 Claude Desktop 中的 Settings 菜单项来定位配置文件。

现在，您需要编辑配置中的 mcpServers 部分。