Skip to content
MCP server

Ssh

MCP server for SSH remote server management with SSH agent authentication support.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.5
Listing updated
5 days ago

About Ssh

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

Install

Run in a terminal

claude mcp add ssh --env SSH_HOST='<SSH_HOST>' --env SSH_USERNAME='<SSH_USERNAME>' --env SSH_PASSPHRASE='<SSH_PASSPHRASE>' -- npx -y ssh-agent-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-agent-mcp-server"
      ],
      "env": {
        "SSH_HOST": "<SSH_HOST>",
        "SSH_USERNAME": "<SSH_USERNAME>",
        "SSH_PASSPHRASE": "<SSH_PASSPHRASE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-agent-mcp-server"
      ],
      "env": {
        "SSH_HOST": "<SSH_HOST>",
        "SSH_USERNAME": "<SSH_USERNAME>",
        "SSH_PASSPHRASE": "<SSH_PASSPHRASE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "ssh": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ssh-agent-mcp-server"
      ],
      "env": {
        "SSH_HOST": "<SSH_HOST>",
        "SSH_USERNAME": "<SSH_USERNAME>",
        "SSH_PASSPHRASE": "<SSH_PASSPHRASE>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-agent-mcp-server"
      ],
      "env": {
        "SSH_HOST": "<SSH_HOST>",
        "SSH_USERNAME": "<SSH_USERNAME>",
        "SSH_PASSPHRASE": "<SSH_PASSPHRASE>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-agent-mcp-server"
      ],
      "env": {
        "SSH_HOST": "<SSH_HOST>",
        "SSH_USERNAME": "<SSH_USERNAME>",
        "SSH_PASSPHRASE": "<SSH_PASSPHRASE>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SSH_HOSTHostname or IP address of the SSH server.Required
  • SSH_USERNAMEUsername for SSH authentication.Required
  • SSH_PORTSSH port number.
  • SSH_AUTH_SOCKPath to SSH agent socket for agent-based authentication.
  • SSH_PRIVATE_KEY_PATHPath to private key file for direct key authentication.
  • SSH_PASSPHRASEPassphrase for encrypted private key.
  • SSH_TIMEOUTConnection timeout in milliseconds.
  • SSH_COMMAND_TIMEOUTDefault command activity timeout in milliseconds.
  • ENABLED_TOOLGROUPSComma-separated list of tool groups to enable (readonly, write, admin).
  • SKIP_HEALTH_CHECKSSkip SSH connection health check on startup.
  • HEALTH_CHECK_TIMEOUTHealth check timeout in milliseconds.

Pricing

Open source

Ssh FAQ

Is Ssh free?

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

How do I add Ssh to Claude Code?

Run this command in your terminal: claude mcp add ssh --env SSH_HOST='<SSH_HOST>' --env SSH_USERNAME='<SSH_USERNAME>' --env SSH_PASSPHRASE='<SSH_PASSPHRASE>' -- npx -y ssh-agent-mcp-server

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers