mcpbeat Sign in

SSH Session MCP Server

local only

SSH Session MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 73 installs a week from npm. Last commit 25 Jun 2026.

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

Installs per day peak 31 · avg 9 · -45% w/w
a month agotoday
73
Installs / week
npm · ssh-session-mcp
4
Stars
1 open issue
25 Jun 2026
Last commit
no releases in 90 days
Apache-2.0
License
TypeScript

What the code does

We read the source, 1 h ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command src/local-shell.ts:24
    this.child = spawn(

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add ssh-session-mcp -- npx -y ssh-session-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "ssh-session-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.ssh-session-mcp]
command = "npx"
args = ["-y", "ssh-session-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "ssh-session-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "ssh-session-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block 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), 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 (Optional legacy password-based SSH authentication value), SSH_KEY (Optional path to a local SSH private key file for legacy single-target mode).

Alternatives to SSH Session MCP

same job, measured the same way
Redmine MCP Stdio
by andrelaptenok

Local MCP (stdio) server for Redmine: issues, projects and time tracking from any MCP client.

71 installs/wk local only
Mimo
by catula

Async MCP game for AI agents: shared poems in English and Russian, a line per move, sealed guesses.

5 tools answering
ssh-mcp
by gelse

MCP gateway for controlled SSH access with per-client auth, command policies, and audit logging.

local only
Vesselapi MCP
by vessel-api

MCP server for the VesselAPI: maritime vessel tracking, port events and emissions

496 installs/wk local only
Gitscrum Core
by gitscrum-core

MCP server for GitScrum — manage tasks, sprints, time tracking, and client workflows via AI

107 installs/wk local only
Gitscrum
by gitscrum

MCP server for GitScrum — manage tasks, sprints, time tracking, and client workflows via AI

local only
my-pi
by boxboxmari

Local-first MCP runtime for coding agents with safe workspace access, AST/LSP navigation, and Git.

54 installs/wk local only
Timero
by timero

Time tracking for agencies: log time, run the timer, check client budgets and pull reports.

answering

SSH Session MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for SSH Session MCP?
SSH Session MCP runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package ssh-session-mcp was installed 73 times last week.
How do I connect SSH Session MCP?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls ssh-session-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use SSH Session MCP?
The npm package ssh-session-mcp was installed 73 times in the last week. Week over week that is -45%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is SSH Session MCP open source?
Yes — it is published under the Apache-2.0 licence, written in TypeScript, 4 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.