SSH Session MCP server
io.github.Zw-awa/ssh-session-mcp·v2.7.1·4 starsShared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules.
4 stars85 downloads/wk
Reviews
Write oneNobody has reviewed SSH Session MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
SSH Session MCP tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan37 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 94 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How SSH Session MCP compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 38% of 48,255 servers
- GitHub stars
- 4
- more than 82% of 28,688 servers
- Downloads a week
- 85
- more than 59% of 12,191 servers with a package
Install SSH Session MCP in Claude Code, Cursor or VS Code
Runs npx -y ssh-session-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add ssh-session-mcp -- npx -y ssh-session-mcp
What the publisher says
From the SSH Session MCP repository's README, as published. We do not edit it. Read it on GitHub
<!-- SPDX-FileCopyrightText: 2026 Zw-awa SPDX-License-Identifier: Apache-2.0 -->
ssh-session-mcp
中文 | English
Persistent shared-terminal runtime for MCP clients over SSH.
ssh-session-mcp gives the user and the AI the same SSH PTY session, adds a browser viewer, tracks who typed what, and makes long-running remote work manageable instead of stateless.
Contents
- Install At A Glance
- Project Structure
- Quick Start
- Docker Status
- MCP Tools
- Configuration Summary
- Security
- Docs
- Development
Install At A Glance
- Normal users do not need to git clone this repository.
- Preferred install path for MCP clients: npx -y ssh-session-mcp --viewerPort=auto
- Preferred install path for human operators who want local binaries: npm install -g ssh-session-mcp
- Official container distribution can be published to a public registry such as docker.io/zwawa/ssh-session-mcp
- git clone is only for contributors, source builds, and local development.
- For the common desktop MCP workflow, npx or a global npm install is still the lowest-friction path. Docker is mainly useful when you want a pinned runtime, container-based deployment, or registry-backed distribution.
Why It Exists
Most SSH-oriented MCP servers can execute commands, but they do not manage terminal state well enough for real collaboration.
ssh-session-mcp focuses on the missing runtime layer:
- One shared PTY for both the human and the AI
- Browser terminal for live inspection and manual intervention
- Input lock so the AI does not type over the user
- Safe/full execution modes for risky commands
- Configurable default policy rules plus session-level custom rule overrides
- Async command tracking for long-running remote work
- Multi-device and multi-connection profile support
- Local debug mode for demos, offline testing, and prompt iteration
Best Fit
- AI-assisted remote development on Linux boards and SSH servers
- Embedded, ROS, training, and deployment hosts that need a real terminal
- Users who want the AI to help, but do not want to surrender the terminal
- MCP Marketplace listings where the install and demo path must be clear
Project Structure
Key directories and files:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
SSH Session MCP: common questions
- Is SSH Session MCP server safe?
- Mostly: it is graded B (72/100). Read the SSH Session MCP safety report
- How do I install SSH Session MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does SSH Session MCP need an API key?
- Yes. The registry entry asks for
SSH_PASSWORD. - Is SSH Session MCP maintained?
- The last commit was 132 days ago (2026-06-25). The latest release is v2.7.1.
- What can I use instead of SSH Session MCP?
- Servers from other publishers that do the same job: SSH — policy-gated remote access MCP server.
- How does SSH Session MCP compare with other MCP servers?
- safety score 72/100 (higher than 38% of 48,255 servers); github stars 4 (more than 82% of 28,688 servers); downloads a week 85 (more than 59% of 12,191 servers with a package). Full comparison.
Alternatives to SSH Session MCP
Same job from other publishers: the closest match first, then the best rated.
- SSH — policy-gated remote accessPolicy-gated, audited SSH for Linux and Windows hosts: roles, approvals, and an audit log.not reviewedEstablishedB