SSH MCP Server
by hypnosisio.github.hypnosis/ssh-mcp-serverv2.3.3
Remote server work via the local OpenSSH client: run commands, transfer files with checksums, search logs and audit hosts, with destructive commands blocked.
context tax
queued
security
queued
cold start
queued
freshness
Maintained46d ago
Install SSH MCP server
Install in Claude Code
claude mcp add ssh -e SSH_PROFILES_FILE='<ssh-profiles-file>' -- npx -y @hypnosis/ssh-mcp-serverInstall in Cursor
{
"mcpServers": {
"ssh": {
"command": "npx",
"args": [
"-y",
"@hypnosis/ssh-mcp-server"
],
"env": {
"SSH_PROFILES_FILE": "<ssh-profiles-file>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"ssh": {
"command": "npx",
"args": [
"-y",
"@hypnosis/ssh-mcp-server"
],
"env": {
"SSH_PROFILES_FILE": "<ssh-profiles-file>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"ssh": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hypnosis/ssh-mcp-server"
],
"env": {
"SSH_PROFILES_FILE": "<ssh-profiles-file>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"ssh": {
"command": "npx",
"args": [
"-y",
"@hypnosis/ssh-mcp-server"
],
"env": {
"SSH_PROFILES_FILE": "<ssh-profiles-file>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| SSH_PROFILES_FILE | yes | — | Absolute path to the JSON file describing the servers this agent may reach. |
| SSH_MCP_LOG_LEVEL | — | — | Log verbosity: error, warn, info or debug. Defaults to info. |
Freshness
Maintained — last maintenance signal 46d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-24 · 46d ago · GitHub
Latest release
2026-08-24 · 46d ago · GitHub · v2.3.3
Package published
no data · npm/PyPI
Registry entry updated
2026-08-24 · 46d ago · official registry · v2.3.3
FAQ
›How do I install the SSH MCP server in Claude Code?
Run: claude mcp add ssh -e SSH_PROFILES_FILE='<ssh-profiles-file>' -- npx -y @hypnosis/ssh-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does SSH require an API key?
Yes. It expects SSH_PROFILES_FILE.
›Can I use SSH as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is SSH in the official MCP registry?
Yes, as io.github.hypnosis/ssh-mcp-server.
Alternatives to SSH
Other monitoring & observability MCP servers.