mcp-server-postgres

mcp-server-postgres

MCP 官方最早的 Postgres 只读参考服务器,现已归档不再维护。

核心功能

这是 MCP 官方最早发布的 Postgres 参考实现,用 Node 编写,只提供一个只读查询工具和表结构资源。随着官方精简参考服务器,它已被移入归档仓库,不再维护、不再提供安全更新;归档说明只把使用者指回仍在维护的 servers 仓库,并未指定官方接替实现。

功能亮点

只读事务

每条语句都包在只读事务里执行,写操作会被数据库层直接回绝。

极小工具面

整个服务器只对外暴露一个查询工具,其余能力全部以资源形式提供。

参考而非产品

定位是演示协议特性的示例代码,官方从未承诺生产环境的可用性。

归档影响

仓库转为只读后不再接受贡献,依赖方需要自行分叉才能修复问题。

适用场景

• 让模型只读地探查数据库表结构
• 自然语言生成并执行统计查询
• 复现依赖该实现的历史配置
• 作为自研数据库服务器的代码起点

安装配置

bash
# 该实现已归档,以下配置仅用于复现历史环境
npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb

# claude_desktop_config.json(NPX 方式)
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    }
  }
}

# 把 /mydb 替换成实际数据库名;连接串是唯一的启动参数

使用方法

bash
工具:query
- 入参 sql(string),只接受只读语句
- 服务端在 READ ONLY 事务中执行,写操作无法生效

资源:postgres://<host>/<table>/schema
- 每张表一条,返回列名与数据类型的 JSON
- 由数据库元数据自动发现,无需手工登记

示例:先列出 schema 资源了解字段,再调用 query 传入 SELECT 语句做聚合统计。

关键指标

尚未核验对标产品,此处只列本工具自身指标,不做对比结论。

指标mcp-server-postgres
价格免费
开源
上手难度入门

相关工具

优点

  • 只读事务从机制上阻止模型误改数据
  • 表结构自动作为资源暴露,无需手写 schema 说明文档
  • 只有一个工具,模型选择工具时几乎不会出错
  • MIT 许可,可直接分叉改造成自维护版本

缺点

  • 仓库已归档,官方声明不再维护也不再提供安全更新
  • 只有一个只读工具,无法建表、写入或执行数据库迁移
  • 连接串通常明文写在客户端配置中,缺少密钥管理机制
  • 除只读事务外,README 未提及其他 SQL 限制或结果集控制手段
  • 依赖 Node 运行时,npx 首次启动需要联网下载