PostgreSQL MCP 服务器

一个提供 PostgreSQL 数据库管理功能的模型上下文协议 (MCP) 服务器。该服务器协助分析现有的 PostgreSQL 设置，提供实施指导，并调试数据库问题。

功能

1. 数据库分析 (analyze_database)

分析 PostgreSQL 数据库配置和性能指标：

• 配置分析
• 性能指标
• 安全评估
• 优化建议

// 示例用法
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "analysisType": "performance" // 可选: "configuration" | "performance" | "security"
}

2. 安装说明 (get_setup_instructions)

提供逐步的 PostgreSQL 安装和配置指导：

• 平台特定的安装步骤
• 配置建议
• 安全最佳实践
• 安装后任务

// 示例用法
{
  "platform": "linux", // 必需: "linux" | "macos" | "windows"
  "version": "15", // 可选: PostgreSQL 版本
  "useCase": "production" // 可选: "development" | "production"
}

3. 数据库调试 (debug_database)

调试常见的 PostgreSQL 问题：

• 连接问题
• 性能瓶颈
• 锁冲突
• 复制状态

// 示例用法
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "issue": "performance", // 必需: "connection" | "performance" | "locks" | "replication"
  "logLevel": "debug" // 可选: "info" | "debug" | "trace"
}

前提条件

• Node.js >= 18.0.0
• PostgreSQL 服务器（用于目标数据库操作）
• 对目标 PostgreSQL 实例的网络访问

安装

1. 克隆存储库
2. 安装依赖项：

   npm install
   

3. 构建服务器：

   npm run build
   

4. 添加到 MCP 设置文件：

   {
     "mcpServers": {
       "postgresql-mcp": {
         "command": "node",
         "args": ["/path/to/postgresql-mcp-server/build/index.js"],
         "disabled": false,
         "alwaysAllow": []
       }
     }
   }
   

开发

• npm run dev - 启动带有热重载的开发服务器
• npm run lint - 运行 ESLint
• npm test - 运行测试

安全注意事项

1. 连接安全

   • 使用连接池
   • 实施连接超时
   • 验证连接字符串
   • 支持 SSL/TLS 连接

2. 查询安全

   • 验证 SQL 查询
   • 阻止危险操作
   • 实施查询超时
   • 记录所有操作

3. 身份验证

   • 支持多种身份验证方法
   • 实施基于角色的访问控制
   • 强制执行密码策略
   • 安全地管理连接凭据

最佳实践

1. 始终使用带有正确凭据的安全连接字符串
2. 对于敏感环境，请遵循生产安全建议
3. 定期监控和分析数据库性能
4. 保持 PostgreSQL 版本为最新
5. 实施适当的备份策略
6. 使用连接池以获得更好的资源管理
7. 实施适当的错误处理和日志记录
8. 定期安全审计和更新

错误处理

服务器实施了全面的错误处理：

• 连接失败
• 查询超时
• 身份验证错误
• 权限问题
• 资源约束

贡献

1. Fork 存储库
2. 创建一个功能分支
3. 提交您的更改
4. 推送到分支
5. 创建一个 Pull Request

许可证

该项目根据 AGPLv3 许可证获得许可 - 有关详细信息，请参见 LICENSE 文件。