Model Context Protocol PostgreSQL Server

基本能力

产品定位

该服务是一个连接PostgreSQL数据库的MCP服务器，旨在为AI模型提供与数据库交互的标准化接口。

核心功能

• 使用连接池连接到PostgreSQL数据库
• 实现Model Context Protocol以支持AI模型交互
• 提供数据库模式信息作为资源
• 支持带有重试逻辑的SQL查询执行
• 优雅处理连接错误

适用场景

• AI模型需要与PostgreSQL数据库交互的场景
• 需要标准化数据库访问协议的项目
• 需要数据库连接管理和错误处理的应用程序

工具列表

• query: 执行带有重试逻辑的SQL查询

常见问题解答

1. 数据库连接问题
2. 检查PostgreSQL是否运行
3. 验证.env文件中的凭据是否正确

4. 确保IP地址有权访问数据库

5. 环境变量问题

6. 确保.env文件位于项目根目录

7. 检查DB_CREDENTIALS中的JSON结构是否有效

8. Cursor集成问题

9. 确保.cursor/mcp.json文件存在且格式正确
10. 尝试重启Cursor以检测项目特定配置

使用教程

使用依赖

• Node.js 20或更高版本
• PostgreSQL数据库
• 数据库访问凭据

安装教程

1. 克隆仓库
2. 安装依赖:

npm install

配置

1. 在项目根目录创建.env文件:

touch .env

1. 添加数据库凭据:

export DB_CREDENTIALS='{"DB_USER":"your-username","DB_PASSWORD":"your-password","DB_HOST":"your-host","DB_PORT":"5433","DB_NAME":"your-database"}'

调试方式

启动服务器:

node server.js

启用详细日志:

node server.js --verbose

许可证

该项目遵循 MIT 开源许可条款。