crystaldba/postgres-mcp

一个支持索引优化、执行计划分析、健康检查及安全 SQL 执行的 Postgres MCP 服务器。

概述 • 演示 • 快速入门 • 技术说明 • MCP API • 相关项目 • 常见问题

概述

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

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

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

Postgres MCP Pro 同时支持 Standard Input/Output (stdio) 和 Server-Sent Events (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 部分。