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. 87 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 33 · avg 12 · -11% w/w
a month agotoday
87
Installs / week
npm · ssh-session-mcp
4
Stars
1 open issues
25 Jun 2026
Last commit
0 releases in 90 days
Apache-2.0
License
TypeScript

What the code does

We read the source, 22 h ago · rules 3dff92dd89df

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": {
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.ssh-session-mcp]
command = "npx"
args = ["-y", "ssh-session-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "ssh-session-mcp": {
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "ssh-session-mcp": {
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: 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.). The author declared them in the registry entry; get the values from the project itself.

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.

82 installs/wk local only
ssh-mcp
by gelse

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

local only
Gitscrum Core
by gitscrum-core

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

72 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.

193 installs/wk local only
Deepseek
by arikusi

MCP server for DeepSeek AI with chat, reasoning, sessions, function calling, and cost tracking

397 installs/wk local only
ControlKeel
by aryaminus

Governed MCP workflows with policy validation, findings tracking, and review gates.

1 377 installs/wk local only
Vesselapi MCP
by vessel-api

MCP server for the VesselAPI — maritime vessel tracking, port events, emissions, and navigation data

68 installs/wk local only

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 87 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 with the file path 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 87 times in the last week. Week over week that is -11%. 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.