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-code2.添加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 install2.配置默认数据库(可选)
您仍然可以使用 .env 本地开发文件:
PG_HOST=localhost
PG_PORT=5432
PG_USER=postgres
PG_PASSWORD=your_password_here
PG_DATABASE=your_database_name3.构建和运行
npm run build
npm start用法示例
配置后,您可以向AI助手询问以下问题:
- “列出数据库中的所有表”
- “描述用户表”
- “从创建的订单中选择\*at>'2025-01-01'”
- “创建一个名为products的新表”
