SSH Session MCP

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

Quality Score

/100

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

Repository →Website →

§00 Trust verdict · v1 advisory · method

UNVERIFIEDno verdict on file

Verdict not yet evaluated for this tool. The hybrid eval runs adversarial cases first; coverage rolls out as the corpus expands. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: hybrid eval, four-state verdict, honest limits.

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "ssh-session-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "env": {
        "SSH_MCP_CONFIG": "<ssh_mcp_config>",
        "SSH_MCP_INSTANCE": "<ssh_mcp_instance>",
        "VIEWER_PORT": "<viewer_port>",
        "VIEWER_HOST": "<viewer_host>",
        "AUTO_OPEN_TERMINAL": "<auto_open_terminal>",
        "SSH_MCP_MODE": "<ssh_mcp_mode>",
        "SSH_MCP_LOCAL": "<ssh_mcp_local>",
        "SSH_MCP_DEBUG": "<ssh_mcp_debug>",
        "SSH_HOST": "<ssh_host>",
        "SSH_PORT": "<ssh_port>",
        "SSH_USER": "<ssh_user>",
        "SSH_PASSWORD": "<your-ssh_password>",
        "SSH_KEY": "<ssh_key>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "ssh-session-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "env": {
        "SSH_MCP_CONFIG": "<ssh_mcp_config>",
        "SSH_MCP_INSTANCE": "<ssh_mcp_instance>",
        "VIEWER_PORT": "<viewer_port>",
        "VIEWER_HOST": "<viewer_host>",
        "AUTO_OPEN_TERMINAL": "<auto_open_terminal>",
        "SSH_MCP_MODE": "<ssh_mcp_mode>",
        "SSH_MCP_LOCAL": "<ssh_mcp_local>",
        "SSH_MCP_DEBUG": "<ssh_mcp_debug>",
        "SSH_HOST": "<ssh_host>",
        "SSH_PORT": "<ssh_port>",
        "SSH_USER": "<ssh_user>",
        "SSH_PASSWORD": "<your-ssh_password>",
        "SSH_KEY": "<ssh_key>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y ssh-session-mcp

§02 Environment variables

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.

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in Calendar & Time

aTars MCP

ai.aarna/atars-mcp

Crypto market signals, technical indicators, and sentiment analysis for AI agents.

Bring Your AI

ai.bringyour/bringyour

No-data MCP handoff for local Claude Code to Codex harness moves. $49 lifetime.

ai.cueapi/mcp

Schedule agent work and report write-once outcomes via CueAPI from any MCP host.