MCP PostgreSQL Server
Overview
基本能力
产品定位
postgres-mcp 是一个专门用于与 PostgreSQL 数据库交互的 MCP 服务器，主要提供数据库查询和模式检查功能。
核心功能
- 提供只读接口查询 PostgreSQL 数据库
- 检查数据库模式
- 支持多种配置方式（环境变量、命令行参数）
- 支持 SSL 连接
- 提供调试日志功能
适用场景
- 数据库查询和分析
- 数据库模式检查和文档生成
- 开发环境中的数据库调试
工具列表
@hthuong09/postgres-mcp: 主服务工具，提供数据库查询和模式检查功能
常见问题解答
- 如何保护数据库凭证安全？ 使用环境变量或 .env 文件代替命令行参数，避免凭证暴露在进程列表中。
- 如何启用调试日志？
设置
DEBUG_MCP=true环境变量，日志将写入/tmp/postgres-mcp-debug.json（Unix/macOS）或%TEMP%/postgres-mcp-debug.json（Windows）。
使用教程
使用依赖
确保已安装 Node.js 和 npm。
安装教程
npm install -g @hthuong09/postgres-mcp
调试方式
DEBUG_MCP=true npx @hthuong09/postgres-mcp
配置方式
- 环境变量
POSTGRES_URL: 完整的数据库 URL- 单独连接参数：
POSTGRES_HOST,POSTGRES_PORT,POSTGRES_DB,POSTGRES_USER,POSTGRES_PASSWORD,POSTGRES_SSL,POSTGRES_SCHEMA -
其他配置：
DOTENV_PATH,DEBUG_MCP -
命令行
bash npx @hthuong09/postgres-mcp "postgres://user:pass@host:5432/dbname"
使用示例
-
使用环境变量:
bash export POSTGRES_HOST=localhost export POSTGRES_DB=mydb export POSTGRES_USER=myuser export POSTGRES_PASSWORD=mypassword npx @hthuong09/postgres-mcp -
使用连接 URL:
bash npx @hthuong09/postgres-mcp "postgres://myuser:mypassword@localhost:5432/mydb" -
使用环境变量和 SSL:
bash export POSTGRES_HOST=db.example.com export POSTGRES_DB=mydb export POSTGRES_USER=myuser export POSTGRES_PASSWORD=mypassword export POSTGRES_SSL=true npx @hthuong09/postgres-mcp -
使用自定义 .env 文件位置:
bash DOTENV_PATH=/path/to/.env npx @hthuong09/postgres-mcp