Token导航 LogoToken导航TokenDH.com
Postgresql Ssh MCP logo
数据服务stdio官方级别未说明来源级核验

Postgresql Ssh MCP

MCP Server

一个安全的PostgreSQL MCP服务器,内置SSH隧道功能,可自动通过堡垒主机连接数据库,无需手动使用ssh -L命令。

工具数

12

提示词数

0

GitHub Stars

6

资源数

0
开发工具PostgreSQLClaude数据库连接Claude DesktopClaude

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

Zlash65

提供方

Zlash65

最后核验

2026/5/17 20:23

运行时

Docker

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

docker run -e DATABASE_URI="postgresql://..." postgresql-mcp

详细介绍

PostgreSQL SSH MCP服务器

](https://www.npmjs.com/package/@zlash65/postgresql-ssh-mcp) ](https://www.npmjs.com/package/@zlash65/postgresql-ssh-mcp) ![license](LICENSE)

一个内置SSH隧道的安全PostgreSQL MCP服务器。通过堡垒主机自动连接到数据库——无需手动 ssh -L 必修的。

特性

  • 双重运输 --STDIO用于克劳德桌面,可流式HTTP用于ChatGPT
  • SSH隧道 --内置隧道,带自动重新连接和TOFU(首次使用时信任)
  • 默认情况下为只读 --安全生产;显式启用写入
  • OAuth支持 --用于安全ChatGPT连接的Auth0集成
  • 连接池 --具有可配置限制的高效资源管理

______________________________________________________________________

建筑

Architecture

______________________________________________________________________

快速开始

克劳德桌面(STDIO)

添加到您的Claude Desktop配置中:

平台配置位置
macOS~/Library/Application Support/Claude/claude_desktop_config.json
窗户%APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@zlash65/postgresql-ssh-mcp"],
      "env": {
        "DATABASE_URI": "postgresql://user:password@localhost:5432/mydb"
      }
    }
  }
}

ChatGPT(流式HTTP)

DATABASE_URI="postgresql://user:pass@localhost:5432/mydb" npx @zlash65/postgresql-ssh-mcp-http

然后配置ChatGPT以连接到 https://your-subdomain.example.com/mcp.

注: ChatGPT需要HTTPS。使用隧道(ngrok、Cloudflare隧道)进行本地测试。

______________________________________________________________________

可用工具

查询工具

工具说明
execute_query使用参数化查询执行SQL。结果上限为 MAX_ROWS.
explain_query获取文本、JSON、YAML或XML格式的EXPLAIN计划。支持分析。

架构工具

工具说明
list_schemas列出数据库架构。默认情况下排除系统架构。
list_tables列出具有行数和大小的表。可选地包括视图。
describe_table获取表的列、约束和索引。
list_databases列出所有数据库及其所有者、编码和大小。

管理工具

工具说明
get_connection_status获取池统计信息、隧道状态和连接信息。
list_active_connections显示来自的活动连接 pg_stat_activity.
list_long_running_queries查找运行时间超过阈值的查询。
get_database_version获取PostgreSQL服务器版本。
get_database_size获取数据库大小和最大表。
get_table_stats获取真空/分析统计数据并扫描表格计数。

______________________________________________________________________

环境变量

数据库连接

变量必填默认描述
DATABASE_URI是\*--完整连接字符串(例如。, postgresql://user:pass@host:5432/db)
DATABASE_HOST是\*--数据库主机名
DATABASE_PORT没有5432数据库端口
DATABASE_NAME是\*--数据库名称
DATABASE_USER是\*--数据库用户名
DATABASE_PASSWORD是\*--数据库密码

\*要么 DATABASE_URI 或者需要所有单独的连接变量。

SSL配置

变量默认值描述
DATABASE_SSL汽车truefalse。非本地主机自动启用。
DATABASE_SSL_CA--CA证书包的路径
DATABASE_SSL_REJECT_UNAUTHORIZEDtrue设置 false 允许自签名证书

SSH隧道

变量必填默认描述
SSH_ENABLED没有false设置 true 启用SSH隧道
SSH_HOST是\*--SSH服务器主机名
SSH_PORT没有22SSH服务器端口
SSH_USER是\*--SSH用户名
SSH_PRIVATE_KEY_PATH是\*\*--私钥文件路径
SSH_PRIVATE_KEY_PASSPHRASE--加密密钥的密码
SSH_PASSWORD是\*\*--SSH密码(密钥替代)
SSH_STRICT_HOST_KEY没有true根据known_hosts验证主机密钥
SSH_TRUST_ON_FIRST_USE没有true自动添加未知主机(启用严格时)
SSH_KNOWN_HOSTS_PATH没有~/.ssh/known_hosts自定义known_hosts文件
SSH_KEEPALIVE_INTERVAL没有10000保持活动间隔(毫秒)
SSH_MAX_RECONNECT_ATTEMPTS没有5最大重新连接尝试次数(-1 无限制)

\*需要时 SSH_ENABLED=true \*\*要么 SSH_PRIVATE_KEY_PATHSSH_PASSWORD 是必需的

查询行为

变量默认值描述
READ_ONLYtrue阻止数据修改。集 false 允许写入。
MAX_ROWS1000每个查询返回的最大行数
QUERY_TIMEOUT30000查询超时(毫秒)
MAX_CONCURRENT_QUERIES10最大并发查询数
POOL_DRAIN_TIMEOUT_MS5000重新连接时排水池超时

HTTP服务器(仅限流式HTTP)

变量默认值描述
PORT3000HTTP服务器端口
MCP_HOST0.0.0.0HTTP服务器绑定地址
MCP_AUTH_MODEnone身份验证模式: noneoauth
MCP_STATELESStrue无状态模式(每个请求重新初始化)
MCP_SERVER_POOL_SIZE4无状态模式的服务器实例
MCP_SESSION_TTL_MINUTES30状态模式的会话TTL
MCP_SESSION_CLEANUP_INTERVAL_MS300000会话清理间隔
MCP_ALLOWED_ORIGINS--允许使用逗号分隔的CORS源(* 任何)
MCP_ALLOWED_HOSTS--允许使用逗号分隔的主机头

OAuth(Auth0)

变量必填描述
AUTH0_DOMAIN是\*Auth0租户域(例如。, tenant.us.auth0.com)
AUTH0_AUDIENCE是\*Auth0 API标识符/受众
MCP_RESOURCE_DOCUMENTATIONAPI文档的URL(RFC 9728)

\*需要时 MCP_AUTH_MODE=oauth

______________________________________________________________________

文档

指南说明
STDIO设置Claude桌面和本地开发
可流式传输的HTTPHTTP服务器设置和配置
服务器安装程序使用nginx和SSL部署到生产环境
ChatGPT设置完成ChatGPT的Auth0 OAuth设置

______________________________________________________________________

码头工人

STDIO服务器

docker build --target runtime -t postgresql-mcp .
docker run -e DATABASE_URI="postgresql://..." postgresql-mcp

HTTP服务器

docker build --target runtime-http -t postgresql-mcp-http .
docker run -p 3000:3000 -e DATABASE_URI="postgresql://..." postgresql-mcp-http

______________________________________________________________________

发展

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Type check
npm run typecheck

# Lint
npm run lint

目录标签

目录标签

开发工具PostgreSQLClaude数据库连接TypeScript混合部署SSH隧道安全连接

支持客户端

Claude DesktopClaude

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

oauth

运行时(runtime,运行环境)

Docker

工具数量(toolCount,工具数)

12

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdiooauth部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP