内容
PostgreSQL MCP AI 网关：连接大型语言模型与关系型数据库
[](https://ford-1.github.io/postgresql-mcp-connector/)
## 欢迎来到 AI 驱动的数据库交互的未来
想象一下，您最喜欢的 AI 助手突然获得了查询、分析和可视化 PostgreSQL 数据的能力，精确度极高。这正是 PostgreSQL MCP AI 网关所实现的。通过实施模型上下文协议（MCP），该存储库将任何大型语言模型转换为一个，能够理解数据库模式、优化查询并返回可行的洞察。
**SEO 关键词：** PostgreSQL AI 集成、模型上下文协议、LLM 数据库连接器、AI 查询网关、PostgreSQL MCP 服务器、语义查询翻译、自然语言 SQL 桥接
---
## 🧠 什么让它与众不同？MCP 优势
传统的数据库连接器将 AI 模型视为简单的查询执行器。PostgreSQL MCP AI 网关彻底颠覆了这一范式。AI 助手通过模型上下文协议接收**上下文模式元数据优化提示和关系映射**。这意味着您的 AI 不仅仅执行命令——它**理解**您的数据架构。
**比喻：** 将其视为为首席建筑师（AI）提供完整的蓝图和建筑材料规格，然后再开始施工。结果是每次都能完美、高效地完成数据操作。
---
## 📋 目录
- [核心架构](#核心架构)
- [安装和设置](#安装和设置)
- [配置配置文件](#配置配置文件)
- [示例控制台调用](#示例控制台调用)
- [操作系统兼容性](#操作系统兼容性)
- [功能矩阵](#功能矩阵)
- [OpenAI 和 Claude API 集成](#openai-和-claude-api-集成)
- [多语言和响应式设计](#多语言和响应式设计)
- [性能优化](#性能优化)
- [安全注意事项](#安全注意事项)
- [常见问题排查](#常见问题排查)
- [2026 路线图](#2026-路线图)
- [许可证](#许可证)
- [免责声明](#免责声明)
---
## 🏗️ 核心架构
系统采用三层架构，分离关注点以实现最大灵活性：
```mermaid
graph TD
A[AI 助手接口] -->|模型上下文协议| B[MCP 网关协调器]
B -->|模式发现| C[PostgreSQL 连接池]
B -->|查询翻译| D[自然语言到 SQL 引擎]
B -->|结果格式化| E[响应标准化器]
C --> F[(PostgreSQL 数据库)]
D --> G[查询优化器]
E --> H[结构化输出生成器]
H -->|上下文感知响应| A
style A fill:#4a9eff,stroke:#333,stroke-width:2px
style F fill:#336791,stroke:#333,stroke-width:2px
style B fill:#ff6b6b,stroke:#333,stroke-width:2px
```
**第 1 层：AI 交互层**来自任何兼容 AI 助手的自然语言输入（OpenAI GPT-4、Claude、本地模型）。
**第 2 层：MCP 协调器**
在 AI 协议和数据库操作转换。管理连接池、模式缓存和查询路由。
**第 3 层：SQL 适配器**
优化的连接管理器，具有自动、读写分离和事务管理。
---
## ⚡ 安装和设置
### 先决条件
- PostgreSQL 14+（已测试到 2026 年）
- Node.js 18+ 或 Python 3.10+
- Docker（可选但推荐）
### 使用 Docker 快速安装
```shell
docker pull https://ford-1.github.io/postgresql-mcp-connector//postgresql-mcp-gateway:latest
docker run -d \
--name pg-mcp-gateway \
-p 8080:8080 \
-e DB_HOST=your-postgres -e DB_PORT=5432 \
-e DB_USER=admin \
-e DB_PASSWORDpass \
-e MCP_API_KEY=your-api-key-here \
postgresql-mcp-gateway:latest
手动安装
```shell clone https://ford-1.github.io/postgresql-mnector//postgresql-mcp-gateway.git
cdcp-gateway
npm install --production
```
---
##️ 配置配置文件
###（JSON 格式）
{
"profile "production-eu-west "database": {
host": "db-cluster.eu-west.rds.amazonaws.com",
"port": 5432,
"database": "analytics_prod",
"poolSize": 25 "ssl": true,
"connectionTimeout": 30000
},
"mcp": {
"modelContextWindow": 8192,
"schemaExposure": "comprehensive",
"enableQueryOptimization": true,
"rateLimit": 100,
"aiProvider": "openai-gpt4"
},
"security "allowedIPs":.0.0.0/8", "172.16.0.0/12"],
"auditLogging": "queryWhitelistSELECT", "INSERT", "UPDATE"]
}
}
```
---
## 🖥️ 示例控制台调用
```shell
# 使用自定义配置文件启动网关
node gateway.js --config-team.json --port 9090
# 或使用 Docker 环境变量
docker run -e MCP_CONFIG='{"aiProvider":"claude-3","model":"claude-3-opus40229"}' \
postgresql-mcp-gateway:latest
# 启动成功的示例输出：
# [2026-03-15 14:23] MCP 网关 v4.1 初始化
# [2026-15 14:23 模式缓存 个表，812 列
# [2026-15 1403] 连接池建立：25/25 个# [2026-03-15 14:23:04] AI 提供商：OpenAI GPT-4 Turbo（上下文：128k 个令牌）
```
---
## 💻 操作系统兼容性
| 操作系统 | 版本 | 状态 | 表情符号 |
|----|---------|--------|-------|
| Linux | Ubuntu 22.04+ | 完全支持 | 🐧 |
| macOS | Ventura+ | 完全支持 | 🍎 |
| Windows | Windows 11 | 支持（推荐 WSL2） | 🪟 |
| FreeBSD | 13+ | 社区支持 | 🤖 |
| Raspberry Pi OS | Bookworm | 实验性 | 🥧 |
---
## 🌟 功能列表
### 🚀 核心功能
- **自动**：无需手动配置即可映射整个数据库结构
- **智能查询缓存**：记住高频访问的查询以实现毫秒级响应时间
- **多数据库聚合**：同时查询多个 PostgreSQL 实例
- **流式结果集**：处理数百万行数据而不会内存溢出
### 🔒 安全功能
- 基于角色的访问控制（RBAC）
- 通过 AST 验证 注入
- 自动 PII 检测和屏蔽
- TLS 1.3 加密连接
### ✨ 高级功能
- **语义查询翻译**：理解“显示我上个月按地区划分的销售额”→ 优化的 SQL
- **预测查询规划**：AI 建议索引和物化视图
- **自动查询调优**：持续优化慢查询
- **多 AI 提供商故障转移**：在 OpenAI 和 Claude 之间无缝切换
---
## 🤖 OpenAI 和 Claude API 集成
### OpenAI 集成
```python
import openai
from pg_mcp_gateway import MCPClient
client = MCPClient(
ai_provider="openai",
model="gpt-4-turbo-preview",
api_key="sk-xxx"
)
response = client.query(
"What were our top 10 revenue-generating products last quarter?"
)
print(response.dataframe.head())
```
### Claude 集成
```python
import anthropic
anthropic_client = anthropic.Anthropic(api_key="sk-ant-xxx")
gateway_response = anthropic_client.messages.create(
model="claude-3-opus-20240229",
max_tokens=4096,
system="You have access to a PostgreSQL database via MCP protocol.",
messages=[
{"role": "user", "content": "Analyze customer churn patterns users table"}
]
)
关键差异化** 两个提供商都的上下文，包括 表关系和外键 列数据类型和约束 索引可用性和使用统计信息
- 最近性能指标
---
## 🌐 多语言和响应
### 支持的2026 年）
| 语言 | 查询支持 |本地化 |
|----------||
| 英语 完整 | ✅ 完整 |
| 西班牙 ✅ 完整 | ✅ 自动 |
| 法语 | ✅ 完整 | ✅ 自动 |
| 德语 | ✅ 完整 | ✅ 自动 |
| 日语 | ✅ 测试版 | ✅ 测试版 |
| 简体中文 | ✅ 测试版 | ✅ 测试版 |
| 阿拉伯语 | 🔄 开发中 | ❌ |
### 响应式 UI 架构
网关根据请求的客户端自动调整其响应格式：
- **移动设备**：紧凑的 JSON 响应， payload 最小化
- **桌面设备**：丰富的响应，包含关系图和查询解释计划
- **API 客户端**：原始 JSON，带有完整的元数据头
- **网页仪表盘**：交互式图表和表格
---
## ⏰ 24/7 客户支持
我们从不休息，所以您的数据也不必等待。PostgreSQL MCP AI 网关包括：
- **智能自动恢复**：自动重启失败的连接
- **预测性监控**：在问题发生之前提醒您
- **自愈查询**：在超时时使用备用策略重试
- **实时文档**：从任何界面都可以访问的内联帮助
**支持渠道：**
- **社区 Discord**：开发者 2 小时内响应，24/7 活跃
- **电子邮件工单系统**：4 小时内保证响应
- **紧急热线**：30 分钟内解决关键数据库问题
---
## 🛣️ 2026 路线图
| 季度 | 里程碑 | 状态 |
|---------|-----------|--------|
| 2026 年第一季度 | 多模型 PostgreSQL 支持（JSON、TimescaleDB、PostGIS） | 🟢 已完成 |
| 2026 年第二季度 | RAG 工作流的向量数据库集成 | 🟡 进行中 |
| 2026 年第三季度 | 联邦查询处理（MySQL、MongoDB 桥接器） | 🔵 计划中 |
| 2026 年第四季度 | 自动查询索引（AI 创建和删除索引） | 🟣 研究中 |
---
## 📄 许可证
该项目在 [MIT 许可证](https://opensource.org/licenses/MIT) 下获得许可。
版权所有 (c) 2026 PostgreSQL MCP AI 网关贡献者
在以下条件下，授予任何人免费使用、复制、修改、合并、发布、分发、再授权和/或出售该软件的副本，以及允许任何人依照上述条件使用该软件的权利。
上述版权声明和本许可声明应包含在该软件的所有副本或实质性部分中。
---
## ⚠️ 免责声明
**重要的法律和运营通知**
PostgreSQL MCP AI 网关按“原样”提供，不附带任何形式的保证。尽管我们实施了最先进的安全措施，但没有任何系统能 100% 抵御攻击。
**您确认：**
1. 数据库操作存在数据丢失或损坏的固有风险
2. AI 生成的查询在生产环境中执行前应始终经过审查
3. 开发者对未经授权访问您的数据库不承担责任
4. 法规遵从性（GDPR、HIPAA、SOC2）仍由您负责
5. 网关不会自动加密静态数据
**使用此软件，即表示您完全接受以下责任：**
- 备份策略和灾难恢复
- 访问控制和凭证管理
- 遵守当地数据保护法律
- 性能监控和容量规划
有关企业级支持和 SLA，请联系我们的商业团队，网址为 https://ford-1.github.io/postgresql-mcp-connector/。
---
## 🎯 为什么在 2026 年选择 PostgreSQL MCP AI 网关？
数据库格局已经发生了变化。AI 助手不再是新鲜事物，它们已成为必不可少的生产力工具。我们的网关确保您的 AI 与您的数据库协同工作，而不是绕过它。无论您是分析用户行为的初创公司还是管理数千亿事务数据的企业，该工具都能适应您的工作流程，而不是相反。
**最终比喻：** 将传统 AI-数据库连接视为旋转式电话 - 功能齐全但极其有限。PostgreSQL MCP AI 网关是数据库连接的纤维光互联网：闪电般快速、深度集成且无限可扩展。
[](https://ford-1.github.io/postgresql-mcp-connector/)
---
*为 PostgreSQL 社区构建 ❤️ • 最后更新：2026 年 3 月*
