SSH Session MCP
Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules.
Install SSH Session MCP in your MCP client
SSH Session MCP is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.
- Locate your client's MCP config file.
- Cursor:
~/.cursor/mcp.json - Claude Desktop (macOS):
~/Library/Application Support/Claude/claude_desktop_config.json - Claude Desktop (Windows):
%APPDATA%\Claude\claude_desktop_config.json - VS Code:
Settings → Extensions → MCP - Windsurf:
Settings → MCP Servers
- Cursor:
- Add SSH Session MCP to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing
mcpServersobject. - Restart your client so it picks up the new server.
- Verify — ask the assistant to list available tools; SSH Session MCP's tools should appear.
{
"mcpServers": {
"ssh-session-mcp": {
"command": "npx",
"args": [
"-y",
"ssh-session-mcp"
],
"env": {
"SSH_MCP_CONFIG": "<your-ssh-mcp-config>",
"SSH_MCP_INSTANCE": "<your-ssh-mcp-instance>",
"VIEWER_PORT": "<your-viewer-port>",
"VIEWER_HOST": "<your-viewer-host>",
"AUTO_OPEN_TERMINAL": "<your-auto-open-terminal>",
"SSH_MCP_MODE": "<your-ssh-mcp-mode>",
"SSH_MCP_LOCAL": "<your-ssh-mcp-local>",
"SSH_MCP_DEBUG": "<your-ssh-mcp-debug>",
"SSH_HOST": "<your-ssh-host>",
"SSH_PORT": "<your-ssh-port>",
"SSH_USER": "<your-ssh-user>",
"SSH_PASSWORD": "<your-ssh-password>",
"SSH_KEY": "<your-ssh-key>"
}
}
}
}Install SSH Session MCP in Cursor
Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. SSH Session MCP will show up in the assistant's tool list on next launch.
Install SSH Session MCP in Claude Desktop (macOS)
Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). SSH Session MCP will show up in the assistant's tool list on next launch.
Install SSH Session MCP in Claude Desktop (Windows)
Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). SSH Session MCP will show up in the assistant's tool list on next launch.
Install SSH Session MCP in VS Code
Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. SSH Session MCP will show up in the assistant's tool list on next launch.
npm package: ssh-session-mcp
Required environment variables
SSH Session MCP needs the following environment variables set before it can run. Add them to the env block of your mcpServers entry, or export them in your shell before launching the client.
SSH_MCP_CONFIGSSH_MCP_INSTANCEVIEWER_PORTVIEWER_HOSTAUTO_OPEN_TERMINALSSH_MCP_MODESSH_MCP_LOCALSSH_MCP_DEBUGSSH_HOSTSSH_PORTSSH_USERSSH_PASSWORDSSH_KEY
Transport
SSH Session MCP supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.
More automate.devops.runbooks MCP servers
Other Model Context Protocol servers in the same space as SSH Session MCP. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.
Interminal
Lightweight MCP server providing terminal access (SSH & local shells) for AI assistants.
f5xc-terraform-mcp
MCP server for F5 Distributed Cloud Terraform provider - documentation, 270+ OpenAPI specs, subscription info, and addon activation workflows for AI assistants
Azure DevOps (ADO)
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
ssh-mcp
MCP server for SSH operations with built-in diagnostics
server
Security, cost, and health governance proxy for MCP infrastructure — three-layer detection engine (regex + schema + LLM), monorepo, corpus, CI/CD
k8scortex-mcp
Kubernetes MCP server: 75 tools for GKE, AKS, EKS, RBAC, audit logging, GitOps, multi-cluster.
recourse-cli
MCP server for AI agents to evaluate consequences before destructive actions. Analyzes Terraform plans, shell commands, and MCP tool calls.
Honey MCP Server
Search instances across GCP, AWS, K8s, Consul & Proxmox
Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.