SSH Session MCP

MCP server · by Zw-awa

Developer Tools npm v2.7.1

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

View source ↗ Website ↗ Generate config for multiple servers More servers

Install

Pin version registry version 2.7.1

npm
npx -y ssh-session-mcp

npm
npx -y ssh-session-mcp@2.7.1

Setup by client

Pick your client — the config below is generated for this server (local stdio). Copy respects the “Pin version” switch above.

claude_desktop_config.json

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

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

Format verified against the official Claude Desktop docs ↗.

terminal

claude mcp add ssh-session-mcp -- npx -y ssh-session-mcp

claude mcp add ssh-session-mcp -- npx -y ssh-session-mcp@2.7.1

Format verified against the official Claude Code docs ↗.

.cursor/mcp.json

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

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

Format verified against the official Cursor docs ↗.

.vscode/mcp.json

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

{
  "servers": {
    "ssh-session-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp@2.7.1"
      ]
    }
  }
}

Format verified against the official VS Code docs ↗.

mcp_config.json

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

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

Format verified against the official Windsurf docs ↗.

Environment variables

Defined in the server's official registry manifest. Required secrets are shown as <YOUR_…> placeholders in the configs above.

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.

GitHub

⭐ 4 stars · 最近更新于 126 天前 · Apache-2.0 license

About this server

Distributed as npm, listed under Developer Tools. Review our MCP security guide before granting access to real data.

Frequently asked questions

How do I install SSH Session MCP?

Run the install command shown above, then paste the config for your client (Claude Desktop, Claude Code, Cursor, VS Code or Windsurf) into its MCP settings and restart the client.

Is SSH Session MCP free to use?

The MCP server itself is free to install. The source is public on https://github.com/Zw-awa/ssh-session-mcp. Any third-party service it calls may require its own API key and account.

Which clients support SSH Session MCP?

Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.

Add this badge

Publish this server? Link back with a badge on your README or site — copy either snippet.

Markdown

[![Listed on MCPNav](https://mcpnav.net/badge/ssh-session-mcp.svg)](https://mcpnav.net/server/ssh-session-mcp/)

HTML

<a href="https://mcpnav.net/server/ssh-session-mcp/"><img src="https://mcpnav.net/badge/ssh-session-mcp.svg" alt="Listed on MCPNav" height="20"></a>