SSH Session MCP Server
by zw-awaio.github.Zw-awa/ssh-session-mcpv2.7.1
Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules.
context tax
queued
security
queued
cold start
queued
freshness
Slowing4mo ago
Install SSH Session MCP server
Install in Claude Code
claude mcp add ssh-session -e SSH_PASSWORD='<ssh-password>' -- npx -y ssh-session-mcpInstall in Cursor
{
"mcpServers": {
"ssh-session": {
"command": "npx",
"args": [
"-y",
"ssh-session-mcp"
],
"env": {
"SSH_PASSWORD": "<ssh-password>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"ssh-session": {
"command": "npx",
"args": [
"-y",
"ssh-session-mcp"
],
"env": {
"SSH_PASSWORD": "<ssh-password>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"ssh-session": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ssh-session-mcp"
],
"env": {
"SSH_PASSWORD": "<ssh-password>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"ssh-session": {
"command": "npx",
"args": [
"-y",
"ssh-session-mcp"
],
"env": {
"SSH_PASSWORD": "<ssh-password>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| 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 | — | yes | Optional legacy password-based SSH authentication value. |
| SSH_KEY | — | — | Optional path to a local SSH private key file for legacy single-target mode. |
Freshness
Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-06-25 · 4mo ago · GitHub
Latest release
2026-05-27 · 5mo ago · GitHub · v2.8.0
Package published
no data · npm/PyPI
Registry entry updated
2026-05-15 · 5mo ago · official registry · v2.7.1
FAQ
›How do I install the SSH Session MCP server in Claude Code?
Run: claude mcp add ssh-session -e SSH_PASSWORD='<ssh-password>' -- npx -y ssh-session-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does SSH Session require an API key?
Yes. It expects SSH_PASSWORD, of which 1 is a secret.
›Can I use SSH Session as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is SSH Session in the official MCP registry?
Yes, as io.github.Zw-awa/ssh-session-mcp.