MCP 服务器

PostgreSQL MCP Server
精选

一个模型上下文协议服务器，通过自然语言交互实现强大的 PostgreSQL 数据库管理功能，包括分析、模式管理、数据迁移和监控。

数据库交互

数据与应用分析

访问服务器

README

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"
}

模式管理

4. 模式信息 (`get_schema_info`)

获取数据库或特定表的详细模式信息：

数据库中的表列表
列定义
约束 (主键，外键等)
索引

// 示例用法
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "tableName": "users" // 可选: 获取特定表的信息
}

5. 创建表 (`create_table`)

创建具有指定列的新表：

定义列名和类型
设置可空约束
设置默认值

// 示例用法
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "tableName": "users",
  "columns": [
    { "name": "id", "type": "SERIAL", "nullable": false },
    { "name": "username", "type": "VARCHAR(100)", "nullable": false },
    { "name": "email", "type": "VARCHAR(255)", "nullable": false },
    { "name": "created_at", "type": "TIMESTAMP", "default": "NOW()" }
  ]
}

6. 修改表 (`alter_table`)

修改现有表：

添加新列
修改列类型或约束
删除列

// 示例用法
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "tableName": "users",
  "operations": [
    { "type": "add", "columnName": "last_login", "dataType": "TIMESTAMP" },
    { "type": "alter", "columnName": "email", "nullable": false },
    { "type": "drop", "columnName": "temporary_field" }
  ]
}

数据迁移

7. 导出表数据 (`export_table_data`)

将表数据导出为 JSON 或 CSV 格式：

使用 WHERE 子句过滤数据
限制行数
选择输出格式

// 示例用法
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "tableName": "users",
  "outputPath": "./exports/users.json",
  "where": "created_at > '2023-01-01'", // 可选
  "limit": 1000, // 可选
  "format": "json" // 可选: "json" | "csv"
}

8. 导入表数据 (`import_table_data`)

从 JSON 或 CSV 文件导入数据：

可选地在导入前截断表
支持不同的格式
自定义 CSV 分隔符

// 示例用法
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "tableName": "users",
  "inputPath": "./imports/users.json",
  "truncateFirst": false, // 可选
  "format": "json", // 可选: "json" | "csv"
  "delimiter": "," // 可选: 用于 CSV 文件
}

9. 数据库之间复制 (`copy_between_databases`)

在两个 PostgreSQL 数据库之间复制数据：

使用 WHERE 子句过滤数据
可选地截断目标表

// 示例用法
{
  "sourceConnectionString": "postgresql://user:password@localhost:5432/source_db",
  "targetConnectionString": "postgresql://user:password@localhost:5432/target_db",
  "tableName": "users",
  "where": "active = true", // 可选
  "truncateTarget": false // 可选
}

监控

10. 监控数据库 (`monitor_database`)

PostgreSQL 数据库的实时监控：

数据库指标 (连接数，缓存命中率等)
表指标 (大小，行数，死元组)
活动查询信息
锁信息
复制状态
可配置的警报

// 示例用法
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "includeTables": true, // 可选
  "includeQueries": true, // 可选
  "includeLocks": true, // 可选
  "includeReplication": false, // 可选
  "alertThresholds": { // 可选
    "connectionPercentage": 80,
    "longRunningQuerySeconds": 30,
    "cacheHitRatio": 0.95,
    "deadTuplesPercentage": 10,
    "vacuumAge": 7
  }
}

前提条件

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

安装

克隆存储库
安装依赖项：
```
npm install
```
构建服务器：
```
npm run build
```

添加到 MCP 设置文件：

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