Skip to content
MCP server

SSH MCP Server

Modern SSH for AI agents — cloud servers to BusyBox routers, with destructive commands…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
2.3.3
Listing updated
4 days ago

About SSH MCP Server

SSH MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Modern SSH for AI agents — cloud servers to BusyBox routers, with destructive commands blocked.

Install

Run in a terminal

claude mcp add ssh-mcp-server --env SSH_PROFILES_FILE='<SSH_PROFILES_FILE>' -- npx -y @hypnosis/ssh-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ssh-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@hypnosis/ssh-mcp-server"
      ],
      "env": {
        "SSH_PROFILES_FILE": "<SSH_PROFILES_FILE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ssh-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@hypnosis/ssh-mcp-server"
      ],
      "env": {
        "SSH_PROFILES_FILE": "<SSH_PROFILES_FILE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "ssh-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hypnosis/ssh-mcp-server"
      ],
      "env": {
        "SSH_PROFILES_FILE": "<SSH_PROFILES_FILE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ssh-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@hypnosis/ssh-mcp-server"
      ],
      "env": {
        "SSH_PROFILES_FILE": "<SSH_PROFILES_FILE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ssh-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@hypnosis/ssh-mcp-server"
      ],
      "env": {
        "SSH_PROFILES_FILE": "<SSH_PROFILES_FILE>"
      }
    }
  }
}

Configuration

  • SSH_PROFILES_FILEAbsolute path to the JSON file describing the servers this agent may reach.Required
  • SSH_MCP_LOG_LEVELLog verbosity: error, warn, info or debug. Defaults to info.

Pricing

Open source

SSH MCP Server FAQ

Is SSH MCP Server free?

Yes. SSH MCP Server is open source, so you can use and self-host it for free.

How do I add SSH MCP Server to Claude Code?

Run this command in your terminal: claude mcp add ssh-mcp-server --env SSH_PROFILES_FILE='<SSH_PROFILES_FILE>' -- npx -y @hypnosis/ssh-mcp-server