MCP PostgreSQL Server

基本能力

产品定位

MCP PostgreSQL Server 是一个专门为 AI 模型设计的 PostgreSQL 数据库操作服务，通过标准化接口简化数据库交互。

核心功能

• 数据库连接管理：支持安全地连接和断开 PostgreSQL 数据库。
• 查询执行：支持 SELECT、INSERT、UPDATE、DELETE 等 SQL 查询操作。
• 表结构查看：可以列出数据库中的所有表，并查看特定表的结构。
• 参数化查询：支持 PostgreSQL 风格和 MySQL 风格的参数占位符。
• 自动连接管理：自动处理连接的创建和清理。

适用场景

• AI 模型需要与 PostgreSQL 数据库进行交互的场景。
• 需要执行复杂 SQL 查询或数据操作的自动化任务。
• 开发过程中需要快速查看数据库结构和表信息的场景。

工具列表

1. connect_db：建立与 PostgreSQL 数据库的连接。
2. query：执行 SELECT 查询，支持参数化查询。
3. execute：执行 INSERT、UPDATE 或 DELETE 操作，支持参数化查询。
4. list_tables：列出数据库中的所有表。
5. describe_table：查看特定表的结构。

常见问题解答

• 连接失败：检查环境变量中的数据库连接信息是否正确。
• 查询错误：确保 SQL 语法正确，参数占位符使用正确。
• 表不存在：使用 list_tables 确认表名是否正确。

使用教程

使用依赖

确保已安装 Node.js 和 npm。

安装教程

npm install mcp-postgres-server

或直接运行：

npx mcp-postgres-server

配置

设置以下环境变量：

{
  "mcpServers": {
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-postgres-server"],
      "env": {
        "PG_HOST": "your_host",
        "PG_PORT": "5432",
        "PG_USER": "your_user",
        "PG_PASSWORD": "your_password",
        "PG_DATABASE": "your_database"
      }
    }
  }
}

调试方式

1. 确保环境变量配置正确。
2. 使用 connect_db 工具测试数据库连接。
3. 使用 query 或 execute 工具测试查询功能。
4. 检查错误消息以定位问题。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。