mcpField
P
PostgreSQL MCP Server

PostgreSQL MCP Server

本地服务
github.com/1Levick3数据库178 周前更新

关于 PostgreSQL MCP Server

PostgreSQL MCP Server 为 PostgreSQL 数据库提供直接执行 SQL 查询的能力,面向 Cursor IDE 用户。它支持参数化查询、可配置超时及连接池等连接安全措施。

主要功能

  1. 01执行自定义 SQL 查询
  2. 02支持参数化查询
  3. 03可配置查询超时
  4. 04连接池与连接超时
  5. 05支持 SSL/TLS 连接

适用场景

  1. 01在 Cursor 中查询 PostgreSQL 数据
  2. 02使用参数化 SQL 执行数据库操作
  3. 03通过 SSL/TLS 连接数据库

MCP 相关

该 MCP 服务向客户端提供 PostgreSQL 查询执行能力。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"postgresql-mcp-server-1levick3": {
"command": "npx",
"args": [
"-y",
"@smithery/cli"
]
}
}
}
启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@smithery/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

PostgreSQL MCP 服务

smithery badge

一个模型上下文协议(MCP)服务,可直接执行 PostgreSQL 数据库查询。此服务支持针对 PostgreSQL 数据库执行自定义 SQL 查询,并支持参数化查询和可配置的超时时间。本项目专为与 Cursor IDE 配合使用而设计。

前提条件

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

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 PostgreSQL 数据库查询服务:

npx -y @smithery/cli install @1Levick3/postgresql-mcp-server --client claude
手动安装
  1. 克隆仓库
  2. 安装依赖:
    npm install
    
  3. 构建服务:
    npm run build
    
  4. 添加到 MCP 设置文件:
     {
       "mcpServers": {
         "postgresql-mcp": {
           "command": "node",
           "args": ["/Users/1Levick3/Desktop/postgresql-mcp-server/build/index.js"],
           "disabled": false,
           "alwaysAllow": [],
           "env": {
             "POSTGRES_CONNECTION_STRING": "postgresUrl",
             "POSTGRES_SSL_CERT_PATH": "/Users/1levick3/Desktop/root.crt"
           }
         }
       }
     }
    

开发

  • npm run dev - 启动支持热重载的开发服务
  • npm run lint - 运行 ESLint
  • npm test - 运行测试

安全注意事项

  1. 连接安全
    • 使用连接池
    • 实施连接超时
    • 验证连接字符串
    • 支持 SSL/TLS 连接

贡献

  1. 复刻仓库
  2. 创建功能分支
  3. 提交更改
  4. 推送到分支
  5. 创建拉取请求

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。