PostgreSQL MCP 服务器

概述

PostgreSQL MCP（模型上下文协议）服务器是一个用于管理和操作 PostgreSQL 数据库的工具。它提供了多种功能，包括数据库分析、调试、模式管理、数据迁移和实时监控。

功能

1. 数据库分析

• 描述: 提供对 PostgreSQL 数据库的全面分析，包括性能指标和健康检查。
• 示例:

  // 分析数据库性能
  const analysis = await postgresqlMcpServer.analyzeDatabase(connectionString);
  

2. 数据库调试

• 描述: 帮助识别和解决数据库中的问题，包括查询优化和错误排查。
• 示例:

  // 调试具体查询
  const debugResult = await postgresqlMcpServer.debugQuery(connectionString, query);
  

3. 模式管理

• 描述: 提供对数据库模式的管理和操作功能，包括表、索引和视图等。
• 示例:

  // 获取数据库模式
  const schema = await postgresqlMcpServer.getSchema(connectionString);
  

4. 数据迁移

• 描述: 支持在不同的 PostgreSQL 数据库之间迁移数据，包括过滤和清理操作。
• 示例:

  // 迁移数据
  await postgresqlMcpServer.migrateData(sourceConnectionString, targetConnectionString);
  

5. 实时监控

• 描述: 提供对 PostgreSQL 数据库的实时监控功能，包括性能指标、查询活动和锁信息。
• 示例:

  // 监控数据库状态
  const monitoringResult = await postgresqlMcpServer.monitorDatabase(connectionString);
  

先决条件

• 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": [],
         "env": {
           "POSTGRES_CONNECTION_STRING": "postgresql://username:password@server:port/dbname"
         }
       }
     }
   }
   

开发

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

安全注意事项

1. 连接安全：

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

2. 查询安全：

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

3. 身份验证：

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

最佳实践

1. 始终使用安全的连接字符串，包含适当的凭据
2. 遵循生产环境的安全建议
3. 定期监控和分析数据库性能
4. 保持 PostgreSQL 版本更新
5. 实施适当的数据备份策略
6. 使用连接池以优化资源管理
7. 实现适当的错误处理和日志记录
8. 定期进行安全审核和更新

错误处理

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

• 连接失败
• 查询超时
• 身份验证错误
• 锁定问题

贡献指南

请参考项目仓库中的贡献指南，了解如何为 PostgreSQL MCP 服务器做贡献。

许可证

该项目遵循 LICENSE 协议。