SSH Session MCP

Persistent shared-terminal runtime for MCP clients over SSH. It runs locally over stdio via the published package.

People connecting data & analytics tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-25 · ★ 4 · #39 OF 75 MAINTAINED DATA & ANALYTICS · VERIFIED 2026-08-25

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install SSH Session MCP

before you install - you'll need

Set SSH_HOST, SSH_USER, VIEWER_PORT, SSH_MCP_RUNTIME_MODE, SSH_MCP_STORE, SSH_MCP_REDIS_URL, SSH_MCP_NODE_ID, SSH_MCP_PUBLIC_BASE_URL, SSH_MCP_AUTH_MODE before connecting. SSH_PORT, AUTO_OPEN_TERMINAL, SSH_MCP_MODE are optional or environment-specific per the README.

Claude Code

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

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package ssh-session-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.Zw-awa is GitHub-verified and matches the repo owner

03 · What SSH Session MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v2.8.0 · 2026-05-27

v2.8.0 · This release makes the browser viewer much more practical for day-to-day use, especially when you are working with · more than one session at once. · What's new · Safe / Full is now per session · You can…

v2.7.3 · 2026-05-17

v2.7.3 · Automated release for v2.7.3.

v2.7.1 · 2026-05-15

v2.7.1 · Automated release for v2.7.1.

04 · Who maintains SSH Session MCP

SSH Session MCP is maintained by zw-awa. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

repository: github.com/zw-awa/ssh-session-mcp
website: https://zw-awa.github.io/ssh-session-mcp/
category: data & analytics - ranked #39 of 75 actively-maintained data & analytics servers as of 2026-08-25.
registry: io.github.Zw-awa/ssh-session-mcp (active, first published 2026-05-15)
packages: npm:ssh-session-mcp

06 · SSH Session MCP FAQ

What is SSH Session MCP?

Persistent shared-terminal runtime for MCP clients over SSH. It runs locally over stdio via the published package.

Is SSH Session MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-25. We re-verify nightly.

How do I install SSH Session MCP?

Run `npx -y ssh-session-mcp`. The README documents 12 environment variables (SSH_HOST, SSH_PORT, SSH_USER…) to set first. Set SSH_HOST, SSH_USER, VIEWER_PORT, SSH_MCP_RUNTIME_MODE, SSH_MCP_STORE, SSH_MCP_REDIS_URL, SSH_MCP_NODE_ID, SSH_MCP_PUBLIC_BASE_URL, SSH_MCP_AUTH_MODE before connecting. SSH_PORT, AUTO_OPEN_TERMINAL, SSH_MCP_MODE are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does SSH Session MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to SSH Session MCP

Alternatives to SSH Session MCP

Maintained data & analytics servers if SSH Session MCP isn't the fit.

Pairs well with

Servers that cover what SSH Session MCP doesn't - only shown when the pairing reason fits the companion.

More data & analytics MCP servers · Salesforce Cloud · Picoli MCP · Sipcode · Appfigures

More TypeScript MCP servers · Slideshot · Palmyr · AI Proof of Us · Escrow · Solenrich · see all