PostgreSQL MCP Server

PostgreSQL MCP Server

site icon
2025.04.29 0
TypeScript数据库服务开发工具数据库
PostgreSQL MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,专门为 Cursor IDE 设计,提供直接执行 PostgreSQL 数据库查询的能力。它支持参数化查询和可配置的超时设置,使得开发者能够灵活地与 PostgreSQL 数据库进行交互。
View on GitHub

Overview

基本能力

产品定位

PostgreSQL MCP Server 是一个专为 Cursor IDE 设计的数据库查询服务,旨在提供高效、安全的 PostgreSQL 数据库操作能力。

核心功能

  • 直接执行自定义 SQL 查询
  • 支持参数化查询
  • 可配置的查询超时设置
  • 连接池管理
  • SSL/TLS 连接支持

适用场景

  • 在 Cursor IDE 中直接操作 PostgreSQL 数据库
  • 需要执行复杂 SQL 查询的开发环境
  • 需要参数化查询以提高安全性的场景
  • 需要控制查询超时的生产环境

工具列表

  • npm run dev: 启动开发服务器,支持热重载
  • npm run lint: 运行 ESLint 进行代码检查
  • npm test: 运行测试

常见问题解答

  1. 连接安全性
  2. 使用连接池管理
  3. 实现连接超时
  4. 验证连接字符串
  5. 支持 SSL/TLS 连接

使用教程

使用依赖

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

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @1Levick3/postgresql-mcp-server --client claude

手动安装

  1. 克隆仓库
  2. 安装依赖: bash npm install
  3. 构建服务器: bash npm run build
  4. 添加到 MCP 设置文件: json { "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" } } } }

调试方式

  • 启动开发服务器: bash npm run dev
  • 运行测试: bash npm test

许可证

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