SSH Session MCP

MCP

by Zw-awa · v2.7.1

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

mcplocal

MCP configuration

stdio

Command

npx -y ssh-session-mcp@2.7.1

Environment

  • 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_PASSWORDsecret

    Optional legacy password-based SSH authentication value.

  • SSH_KEY

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

Install in one click with Zurek

Browse here, install from the native macOS app — pick targets, fill env vars, and write configs safely.