postgres

mcp-server-postgres

通过 AI 助手查询 PostgreSQL、检查架构并解释查询。这是一款适合日常使用的 MCP，面向本地和开发环境中的 Postgres——与 Docker 和 SQLite 服务配套，而非企业级 DBA 套件。

DATABASE_URL=postgres://user:pass@localhost:5432/mydb npx mcp-pg-server

兼容 Claude Desktop、Cursor、VS Code Copilot 和任何 MCP 客户端。可通过 DATABASE_URL 或每次调用单独指定的 connectionString 连接。

为什么使用

Postgres 是大多数新后端、本地开发环境和需要真实 SQL 数据库的 Agent 工作流的默认选择。你可能已经在 Docker 或 localhost 上运行它——这个服务可让助手查询数据库、读取架构并解释执行计划，无需离开 IDE。默认只读，确保探索安全；需要时可选择启用写入。

工具

工具	功能
query	执行 SQL（SELECT、WITH、EXPLAIN、SHOW、ANALYZE）。返回文本表格。
schema	列出架构中的表（默认为 public），包括列和近似行数
table_info	查看单个表：列、类型、是否允许空值/默认值、主键、精确行数
explain	EXPLAIN（FORMAT TEXT），可选 ANALYZE
list_schemas	列出非系统架构

快速开始

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["mcp-pg-server"],
      "env": {
        "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb"
      }
    }
  }
}

Claude Desktop

添加到 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["mcp-pg-server"],
      "env": {
        "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb"
      }
    }
  }
}

VS Code

在 VS Code 设置中配置 MCP 服务，使其运行 npx mcp-pg-server，并设置 DATABASE_URL。

提示词示例

• “显示 public 表的架构”
• “查询 users：SELECT * FROM users LIMIT 10”
• “解释这个连接查询”
• “这个数据库中有哪些架构？”
• “orders 表中有多少行？”

安全性

默认只读。在只读模式下，query 工具仅接受 SELECT、WITH、EXPLAIN、SHOW 和 ANALYZE。设置 readonly=false 可启用 INSERT、UPDATE、DELETE 和 DDL。

在任何工具调用中传入 connectionString，即可针对单次调用覆盖 DATABASE_URL。

开发

npm install
npm run typecheck
npm run build
npm test
npm run format
npm run lint

另请参阅

更多 MCP 服务和开发者工具，请访问我的作品集。

作者

许可证

MIT © 2026 Ofer Shapira