🚀 PostgreSQL MCP 服务器（模型上下文协议）
本项目实现了快速 MCP（Model Context Protocol）的基本版本，可直接与 PostgreSQL 数据库进行交互。借助该 MCP，能将 AI 聊天体验拓展至多个应用场景，如在 PostgreSQL 数据库中存储和检索聊天数据、利用持久化数据存储创建 AI 应用程序、构建基于结构化数据库查询的知识管理系统、通过自然语言提示直接分析大数据集，以及实现不依赖传统编码的基于数据库的工作流程。此外，该实现利用 MCP 协议，安全地将 Claude AI 与 PostgreSQL 数据库连接起来，在执行操作时能维护适当的隔离和安全边界。
🚀 快速开始
本项目可帮助您借助 MCP 协议实现与 PostgreSQL 数据库的交互，以及与 Claude AI 的集成。以下为您介绍使用前的准备工作和操作步骤。
✨ 主要特性
- 数据库查询：可执行对 PostgreSQL 数据库的查询操作。
- 表管理：支持表的创建与删除操作。
- 数据操作：涵盖数据的选择、插入、更新和删除操作。
- 架构检查：能够检查数据库架构。
- Claude 集成：可通过 MCP 协议与 Claude AI 集成。
📦 安装指南
克隆仓库
将此仓库克隆到本地计算机。
创建并激活 Python 虚拟环境
# 创建虚拟环境
python -m venv .mcp
# 激活虚拟环境
# 在 macOS/Linux 上
source .mcp/bin/activate
# 在 Windows 上
.mcp\Scripts\activate
安装所需依赖项
pip install -r requirements.txt
📚 详细文档
配置
配置 .env 文件
在项目根目录中创建一个 .env 文件，其中包含您的 PostgreSQL 连接详细信息和调试信息。
配置 Claude AI
通过将以下配置添加到 Claude AI 应用程序设置的 MCP 配置部分，使用 Claude 配置 PostgreSQL MCP 服务器：
{
"mcpServers": {
"PostgreSQL MCP": {
"command": "<实际路径>/.mcp/bin/uv",
"args": [
"run",
"--with",
"mcp[cli]",
"--with",
"asyncpg",
"--with",
"httpx",
"--with",
"python-dotenv",
"--with",
"psycopg2-binary",
"mcp",
"run",
"<实际路径>/postgres_mcp_server.py"
],
"env": {
"POSTGRES_HOST": "<您的 PostgreSQL 主机>",
"POSTGRES_PORT": "<您的 PostgreSQL 端口>",
"POSTGRES_USER": "<您的用户名>",
"POSTGRES_PASSWORD": "<您的密码>",
"POSTGRES_DB": "<您的数据库名称>"
}
}
}
}
⚠️ 重要提示
请将“<实际路径>”替换为实际路径，并将此配置添加到 Claude AI 应用程序设置的 MCP 配置部分，这样 Claude 才能连接到您的 PostgreSQL MCP 服务器。