SSH Session MCP
About
Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules.
Use this server
Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.
Transportstdio (runs a local command)
Env vars
SSH_MCP_CONFIG SSH_MCP_INSTANCE VIEWER_PORT VIEWER_HOST AUTO_OPEN_TERMINAL SSH_MCP_MODE SSH_MCP_LOCAL SSH_MCP_DEBUG SSH_HOST SSH_PORT SSH_USER SSH_PASSWORD SSH_KEYClaude Code
claude mcp add --env SSH_MCP_CONFIG= --env SSH_MCP_INSTANCE= --env VIEWER_PORT= --env VIEWER_HOST= --env AUTO_OPEN_TERMINAL= --env SSH_MCP_MODE= --env SSH_MCP_LOCAL= --env SSH_MCP_DEBUG= --env SSH_HOST= --env SSH_PORT= --env SSH_USER= --env SSH_PASSWORD= --env SSH_KEY= ssh-session-mcp -- npx ssh-session-mcp
Cursor
If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.
VS Code
code --add-mcp '{"name":"ssh-session-mcp","command":"npx","args":["ssh-session-mcp"],"env":{"SSH_MCP_CONFIG":"","SSH_MCP_INSTANCE":"","VIEWER_PORT":"","VIEWER_HOST":"","AUTO_OPEN_TERMINAL":"","SSH_MCP_MODE":"","SSH_MCP_LOCAL":"","SSH_MCP_DEBUG":"","SSH_HOST":"","SSH_PORT":"","SSH_USER":"","SSH_PASSWORD":"","SSH_KEY":""}}'
JSON
{
"mcpServers": {
"ssh-session-mcp": {
"command": "npx",
"args": [
"ssh-session-mcp"
],
"env": {
"SSH_MCP_CONFIG": "",
"SSH_MCP_INSTANCE": "",
"VIEWER_PORT": "",
"VIEWER_HOST": "",
"AUTO_OPEN_TERMINAL": "",
"SSH_MCP_MODE": "",
"SSH_MCP_LOCAL": "",
"SSH_MCP_DEBUG": "",
"SSH_HOST": "",
"SSH_PORT": "",
"SSH_USER": "",
"SSH_PASSWORD": "",
"SSH_KEY": ""
}
}
}
}
Environment variables are listed by name only — fill in your own values. Entries never carry secrets.