Postgres MCP Server

🚀 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 服务器。