PostgreSQL MCP Server

PostgreSQL MCP Server

site icon
2025.03.07 16
TypeScript数据库管理性能监控数据迁移数据库
PostgreSQL MCP Server 是一个基于模型上下文协议(MCP)的服务,专注于提供 PostgreSQL 数据库的管理能力。它能够帮助用户分析现有 PostgreSQL 配置、提供实施指导、调试数据库问题、管理数据库模式、迁移数据以及监控数据库性能。
View on GitHub

Overview

基本能力

产品定位

PostgreSQL MCP Server 是一个专为 PostgreSQL 数据库设计的 MCP 服务,旨在简化数据库的管理和维护工作,提高开发者和数据库管理员的效率。

核心功能

  1. 数据库分析与调试
  2. 分析数据库配置和性能指标
  3. 提供安装和配置指导
  4. 调试常见数据库问题

  5. 模式管理

  6. 获取数据库模式信息
  7. 创建和修改表结构

  8. 数据迁移

  9. 导出表数据到 JSON 或 CSV
  10. 从 JSON 或 CSV 导入数据
  11. 在数据库之间复制数据

  12. 监控

  13. 实时监控数据库性能
  14. 配置告警阈值

适用场景

  • 数据库管理员需要快速分析和优化 PostgreSQL 数据库性能
  • 开发者需要自动化数据库模式管理和数据迁移
  • 团队需要实时监控数据库状态并接收告警

工具列表

  1. analyze_database - 分析数据库配置和性能
  2. get_setup_instructions - 提供安装和配置指导
  3. debug_database - 调试数据库问题
  4. get_schema_info - 获取模式信息
  5. create_table - 创建新表
  6. alter_table - 修改表结构
  7. export_table_data - 导出表数据
  8. import_table_data - 导入表数据
  9. copy_between_databases - 在数据库之间复制数据
  10. monitor_database - 监控数据库性能

常见问题解答

  • 连接问题:确保连接字符串正确且网络可达
  • 性能问题:使用 analyze_databasemonitor_database 进行诊断
  • 权限问题:检查数据库用户权限

使用教程

使用依赖

  • Node.js >= 18.0.0
  • PostgreSQL 服务器
  • 网络访问目标 PostgreSQL 实例

安装教程

  1. 克隆仓库
  2. 安装依赖: bash npm install
  3. 构建服务器: bash npm run build
  4. 添加到 MCP 设置文件: json { "mcpServers": { "postgresql-mcp": { "command": "node", "args": ["/path/to/postgresql-mcp-server/build/index.js"], "disabled": false, "alwaysAllow": [] } } }

调试方式

  • 开发模式: bash npm run dev
  • 运行测试: bash npm test
  • 代码检查: bash npm run lint

许可证

该项目遵循 AGPL-3.0 开源许可条款,请参阅 AGPL-3.0 了解完整条款。