Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules.
npx -y ssh-session-mcp{
"SSH_MCP_CONFIG": "YOUR_VALUE_HERE",
"SSH_MCP_INSTANCE": "YOUR_VALUE_HERE",
"VIEWER_PORT": "YOUR_VALUE_HERE",
"VIEWER_HOST": "YOUR_VALUE_HERE",
"AUTO_OPEN_TERMINAL": "YOUR_VALUE_HERE",
"SSH_MCP_MODE": "YOUR_VALUE_HERE",
"SSH_MCP_LOCAL": "YOUR_VALUE_HERE",
"SSH_MCP_DEBUG": "YOUR_VALUE_HERE",
"SSH_HOST": "YOUR_VALUE_HERE",
"SSH_PORT": "YOUR_VALUE_HERE",
"SSH_USER": "YOUR_VALUE_HERE",
"SSH_PASSWORD": "YOUR_SECRET_VALUE",
"SSH_KEY": "YOUR_VALUE_HERE"
}Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-zw-awa-ssh-session-mcp": {
"command": "npx",
"args": [
"-y",
"ssh-session-mcp"
],
"env": {
"SSH_MCP_CONFIG": "YOUR_VALUE_HERE",
"SSH_MCP_INSTANCE": "YOUR_VALUE_HERE",
"VIEWER_PORT": "YOUR_VALUE_HERE",
"VIEWER_HOST": "YOUR_VALUE_HERE",
"AUTO_OPEN_TERMINAL": "YOUR_VALUE_HERE",
"SSH_MCP_MODE": "YOUR_VALUE_HERE",
"SSH_MCP_LOCAL": "YOUR_VALUE_HERE",
"SSH_MCP_DEBUG": "YOUR_VALUE_HERE",
"SSH_HOST": "YOUR_VALUE_HERE",
"SSH_PORT": "YOUR_VALUE_HERE",
"SSH_USER": "YOUR_VALUE_HERE",
"SSH_PASSWORD": "YOUR_SECRET_VALUE",
"SSH_KEY": "YOUR_VALUE_HERE"
}
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
SSH Session MCP is an MCP server for Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules.. It supports STDIO transport.
Use the generated config in Install. This server runs with npx -y ssh-session-mcp; add any required environment variables before starting your client.
Choose the Claude Desktop tab in Install and copy the config for npx -y ssh-session-mcp. Add required environment variables before starting Claude Desktop.
Choose the Claude Code tab in Install and copy the config for npx -y ssh-session-mcp. Add required environment variables before starting Claude Code.
Choose the Codex tab in Install and copy the config for npx -y ssh-session-mcp. Add required environment variables before starting Codex.
Choose the Cursor or VS Code tab in Install and copy the config for npx -y ssh-session-mcp. Add required environment variables before starting Cursor or VS Code.
SSH Session MCP uses STDIO transport. Use the package or command config in Install.
SSH Session MCP inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
SSH Session MCP does not advertise a verified auth requirement. If discovery fails, it may still need provider login, an API key, a bearer token, or a session header.
| Package | Registry | Version | Inputs |
|---|---|---|---|
ssh-session-mcpstdio | npm | 2.7.1 | 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 secret Env: SSH_KEY |