← 返回目录

PostgreSQL MCP Server

官方

已归档

只读连接数据库，安全地做数据分析

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 10 / 58
Stars: ★ 305 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 16 个月前 ⚠
工具数: 4

68FMRS · C

只读接口降低了破坏性风险，但数据库凭据、敏感查询结果和查询负载仍需要额外控制，当前尚未记录真实数据库握手。

最强项 · 安全与权限 16/20 最弱项 · 维护活跃度 10/20

可靠性

15/20

安全与权限

16/20

维护活跃度

10/20

文档质量

14/20

安装易用性

13/20

已人工审核收录于 2026-07-13

查看 FMRS 评分方法 →

选型与风险

能访问什么连接数据库

适合谁

需要用自然语言分析 PostgreSQL 数据的分析师和开发者
希望向助手开放只读数据库结构与查询能力的团队

不适合谁

需要执行写入、迁移或数据库管理操作的场景
不能让第三方模型接触查询结果的敏感数据库

所需权限

PostgreSQL 网络连接权限
专用只读数据库账号及目标 schema 的 SELECT 权限

风险与副作用

查询结果可能包含个人或业务敏感数据
复杂查询仍可能消耗大量数据库资源，建议设置超时和只读副本

安装接入

准备工作

运行环境：Node.js

提供数据库连接字符串作为启动参数，建议使用只读账号。

claude_desktop_config.json

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://readonly:pwd@localhost/db"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://readonly:pwd@localhost/db"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://readonly:pwd@localhost/db

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端的工具列表中应出现 query、list_schemas、list_tables、describe_table 四个工具；可让客户端调用 list_tables，若能返回连接数据库中的表名即说明安装成功。

常见排障

用 psql 验证同一连接串
检查防火墙、SSL 模式和数据库监听地址
确认只读账号拥有目标 schema 的 USAGE 与表 SELECT 权限

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出这个 PostgreSQL 数据库中的所有 schema
显示 public schema 里有哪些表
描述 users 表的结构
查询数据库里最近创建的记录

工具能力 4

query 只读

执行只读 SQL 查询

list_schemas 只读

列出数据库中的所有 schema

list_tables 只读

列出指定 schema 下的表

describe_table 只读

查看表结构与字段类型

使用场景

用自然语言生成报表查询

排查慢查询与索引缺失问题

给新人快速讲解数据库结构

支持客户端

Claude Desktop

Cursor

Cline部分支持

依据项目文档列出，未经本站实测。

详细介绍

以只读模式连接 PostgreSQL，自动读取表结构与索引信息，方便模型编写并解释 SQL 查询，避免误操作生产数据，适合数据分析与排障场景。

同仓库的其他 Server

源版本 9be4674d1ddf 数据同步于 2026-10-14 查看 FMRS 评分方法