AgentHubAgentHub

SSH Session MCP

MCP ServerMCP Registry官方收录

io.github.Zw-awa/ssh-session-mcp · v2.7.1

Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules.

在 MCP Registry 查看 ↗源仓库 ↗

概览

SSH Session MCP 是一个MCP Server，收录自 官方 MCP Registry。支持 stdio 传输。本页提供 Cursor、Claude Code 等客户端的安装配置片段。

安装

选择你的平台查看安装方式

{
  "mcpServers": {
    "ssh-session-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ]
    }
  }
}

环境变量

SSH_MCP_CONFIG可选

Optional explicit path to ssh-session-mcp.config.json when the config is not in the current working directory.

SSH_MCP_INSTANCE可选

Optional runtime instance id used to isolate state across multiple MCP clients or agents.

VIEWER_PORT可选

Viewer HTTP port. Use auto to allocate a free local port, or 0 to disable the browser viewer.

VIEWER_HOST可选

Optional viewer bind host. Defaults to 127.0.0.1 for local-only browser access.

AUTO_OPEN_TERMINAL可选

Set to true or 1 to automatically open the browser terminal when a session is created.

SSH_MCP_MODE可选

Operation mode. safe blocks risky or unsuitable terminal actions by default, while full allows broader execution.

SSH_MCP_LOCAL可选

Set to true or 1 to run a local shell instead of opening a real SSH connection. Useful for demos and offline testing.

SSH_MCP_DEBUG可选

Set to true or 1 to expose browser-side debug controls intended for demos and local troubleshooting.

SSH_HOST可选

Legacy single-target SSH host when not using ssh-session-mcp.config.json device profiles.

SSH_PORT可选

Legacy single-target SSH port when not using ssh-session-mcp.config.json device profiles.

SSH_USER可选

Legacy single-target SSH username when not using ssh-session-mcp.config.json device profiles.

SSH_PASSWORD可选secret

Optional legacy password-based SSH authentication value.

SSH_KEY可选

Optional path to a local SSH private key file for legacy single-target mode.

相关资源

统一 Manifest

{
  "id": "io.github.Zw-awa/ssh-session-mcp",
  "type": "mcp-server",
  "version": "2.7.1",
  "displayName": "SSH Session MCP",
  "description": "Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules.",
  "repository": {
    "url": "https://github.com/Zw-awa/ssh-session-mcp",
    "source": "github"
  },
  "homepage": "https://zw-awa.github.io/ssh-session-mcp/",
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "ssh-session-mcp",
        "version": "2.7.1",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "SSH_MCP_CONFIG",
            "description": "Optional explicit path to ssh-session-mcp.config.json when the config is not in the current working directory."
          },
          {
            "name": "SSH_MCP_INSTANCE",
            "description": "Optional runtime instance id used to isolate state across multiple MCP clients or agents."
          },
          {
            "name": "VIEWER_PORT",
            "description": "Viewer HTTP port. Use auto to allocate a free local port, or 0 to disable the browser viewer."
          },
          {
            "name": "VIEWER_HOST",
            "description": "Optional viewer bind host. Defaults to 127.0.0.1 for local-only browser access."
          },
          {
            "name": "AUTO_OPEN_TERMINAL",
            "description": "Set to true or 1 to automatically open the browser terminal when a session is created."
          },
          {
            "name": "SSH_MCP_MODE",
            "description": "Operation mode. safe blocks risky or unsuitable terminal actions by default, while full allows broader execution."
          },
          {
            "name": "SSH_MCP_LOCAL",
            "description": "Set to true or 1 to run a local shell instead of opening a real SSH connection. Useful for demos and offline testing."
          },
          {
            "name": "SSH_MCP_DEBUG",
            "description": "Set to true or 1 to expose browser-side debug controls intended for demos and local troubleshooting."
          },
          {
            "name": "SSH_HOST",
            "description": "Legacy single-target SSH host when not using ssh-session-mcp.config.json device profiles."
          },
          {
            "name": "SSH_PORT",
            "description": "Legacy single-target SSH port when not using ssh-session-mcp.config.json device profiles."
          },
          {
            "name": "SSH_USER",
            "description": "Legacy single-target SSH username when not using ssh-session-mcp.config.json device profiles."
          },
          {
            "name": "SSH_PASSWORD",
            "description": "Optional legacy password-based SSH authentication value.",
            "isSecret": true
          },
          {
            "name": "SSH_KEY",
            "description": "Optional path to a local SSH private key file for legacy single-target mode."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.Zw-awa/ssh-session-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Zw-awa%2Fssh-session-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
SSH Session MCP — MCP Server 安装与配置 · AgentHub