PostgreSQL数据库管理服务

一个连接本地PostgreSQL数据库的MCP服务器,使AI助手能够查询和管理数据库。

  • by aeiyannn
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 aeiyannn/postgree-mcp

使用说明

PostgreSQL MCP服务器

连接到本地PostgreSQL数据库的MCP(模型上下文协议)服务器,使AI助手能够查询和管理您的数据库。

提供的工具

工具 说明
查询 执行只读SQL(SELECT、SHOW、EXPLAIN)
执行 执行写SQL(INSERT、UPDATE、DELETE、CREATE、ALTER、DROP)
list_tables 列出架构中的所有表
describe_table 显示表的列、类型、键和索引
list_schemas 列出数据库中的所有用户模式

资源

  • 模式概述 (postgres://schema/overview)——Markdown中的完整数据库模式概述

通过接头进行动态连接

此服务器支持动态PostgreSQL连接。您可以在初始SSE连接请求中通过HTTP标头提供数据库凭据。这允许服务器的单个部署实例为多个不同的数据库提供服务。

支持的标头

标题 描述 默认值
x-pg-host PostgreSQL主机 PG_HOST 或 localhost
x-pg-port PostgreSQL端口 PG_PORT 或 5432
x-pg-user PostgreSQL用户 PG_USER 或 postgres
x-pg-password PostgreSQL密码 PG_PASSWORD 或 postgres
x-pg-database PostgreSQL数据库 PG_DATABASE 或 postgres
x-pg-ssl 使用SSL(true/false) PG_SSL 或 false
x-pg-ca-cert CA证书 PG_CA_CERT

反重力/光标配置(VS代码)

使用此服务器 反重力 或 光标,将以下内容添加到您的 mcp_config.json (通常在 %APPDATA%\antigravity\ 或IDE的MCP设置):

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://postgree-mcp-dfadduf9bsdvdwa9.eastasia-01.azurewebsites.net/sse",
        "--header", "x-pg-host: pg-168600c0-aeiyankhan2-d42e.g.aivencloud.com",
        "--header", "x-pg-port: 26768",
        "--header", "x-pg-user: avnadmin",
        "--header", "x-pg-password: YOUR_PASSWORD",
        "--header", "x-pg-database: defaultdb",
        "--header", "x-pg-ssl: true"
      ]
    }
  }
}

Claude Code CLI中的配置

如果你使用 克劳德代码CLI,您可以使用以下命令添加此服务器:

1.安装Claude Code(如果尚未安装)

npm install -g @anthropic-ai/claude-code

2.添加PostgreSQL MCP服务器

在终端中运行以下命令:

claude mcp add postgres -- npx mcp-remote https://postgree-mcp-dfadduf9bsdvdwa9.eastasia-01.azurewebsites.net/sse \
  --header "x-pg-host: pg-168600c0-aeiyankhan2-d42e.g.aivencloud.com" \
  --header "x-pg-port: 26768" \
  --header "x-pg-user: avnadmin" \
  --header "x-pg-password: YOUR_PASSWORD" \
  --header "x-pg-database: defaultdb" \
  --header "x-pg-ssl: true"

Claude桌面中的配置

将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://postgree-mcp-dfadduf9bsdvdwa9.eastasia-01.azurewebsites.net/sse",
        "--header", "x-pg-host: pg-168600c0-aeiyankhan2-d42e.g.aivencloud.com",
        "--header", "x-pg-port: 26768",
        "--header", "x-pg-user: avnadmin",
        "--header", "x-pg-password: YOUR_PASSWORD",
        "--header", "x-pg-database: defaultdb",
        "--header", "x-pg-ssl: true"
      ]
    }
  }
}

本地设置(用于开发)

1.安装依赖项

npm install

2.配置默认数据库(可选)

您仍然可以使用 .env 本地开发文件:

PG_HOST=localhost
PG_PORT=5432
PG_USER=postgres
PG_PASSWORD=your_password_here
PG_DATABASE=your_database_name

3.构建和运行

npm run build
npm start

用法示例

配置后,您可以向AI助手询问以下问题:

  • “列出数据库中的所有表”
  • “描述用户表”
  • “从创建的订单中选择*at>'2025-01-01'”
  • “创建一个名为products的新表”