Skip to content
MCP server

SSH Session MCP

Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
2.7.1
Listing updated
5 days ago

About SSH Session MCP

SSH Session MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add ssh-session-mcp --env SSH_PASSWORD='<SSH_PASSWORD>' -- npx -y ssh-session-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "ssh-session-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "env": {
        "SSH_PASSWORD": "<SSH_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SSH_MCP_CONFIGOptional explicit path to ssh-session-mcp.config.json when the config is not in the current working directory.
  • SSH_MCP_INSTANCEOptional runtime instance id used to isolate state across multiple MCP clients or agents.
  • VIEWER_PORTViewer HTTP port. Use auto to allocate a free local port, or 0 to disable the browser viewer.
  • VIEWER_HOSTOptional viewer bind host. Defaults to 127.0.0.1 for local-only browser access.
  • AUTO_OPEN_TERMINALSet to true or 1 to automatically open the browser terminal when a session is created.
  • SSH_MCP_MODEOperation mode. safe blocks risky or unsuitable terminal actions by default, while full allows broader execution.
  • SSH_MCP_LOCALSet to true or 1 to run a local shell instead of opening a real SSH connection. Useful for demos and offline testing.
  • SSH_MCP_DEBUGSet to true or 1 to expose browser-side debug controls intended for demos and local troubleshooting.
  • SSH_HOSTLegacy single-target SSH host when not using ssh-session-mcp.config.json device profiles.
  • SSH_PORTLegacy single-target SSH port when not using ssh-session-mcp.config.json device profiles.
  • SSH_USERLegacy single-target SSH username when not using ssh-session-mcp.config.json device profiles.
  • SSH_PASSWORDOptional legacy password-based SSH authentication value.
  • SSH_KEYOptional path to a local SSH private key file for legacy single-target mode.

Pricing

Open source

Prices change. Check zw-awa.github.io before you buy.

SSH Session MCP FAQ

Is SSH Session MCP free?

Yes. SSH Session MCP is open source, so you can use and self-host it for free.

How do I add SSH Session MCP to Claude Code?

Run this command in your terminal: claude mcp add ssh-session-mcp --env SSH_PASSWORD='<SSH_PASSWORD>' -- npx -y ssh-session-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers