PluginBench
MCP Server

com.pulsemcp/ssh MCP Server

com.pulsemcp/ssh

What is the com.pulsemcp/ssh MCP server?

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

How to install com.pulsemcp/ssh

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • SSH_HOST
    required

    Hostname or IP address of the SSH server.

  • SSH_USERNAME
    required

    Username for SSH authentication.

  • SSH_PORT

    SSH port number.

  • SSH_AUTH_SOCK

    Path to SSH agent socket for agent-based authentication.

  • SSH_PRIVATE_KEY_PATH

    Path to private key file for direct key authentication.

  • SSH_PASSPHRASE
    secret

    Passphrase for encrypted private key.

  • SSH_TIMEOUT

    Connection timeout in milliseconds.

  • SSH_COMMAND_TIMEOUT

    Default command activity timeout in milliseconds.

  • ENABLED_TOOLGROUPS

    Comma-separated list of tool groups to enable (readonly, write, admin).

  • SKIP_HEALTH_CHECKS

    Skip SSH connection health check on startup.

  • HEALTH_CHECK_TIMEOUT

    Health check timeout in milliseconds.

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-agent-mcp-server",
        "-y"
      ],
      "env": {
        "SSH_HOST": "<YOUR_SSH_HOST>",
        "SSH_USERNAME": "<YOUR_SSH_USERNAME>",
        "SSH_PORT": "<YOUR_SSH_PORT>",
        "SSH_AUTH_SOCK": "<YOUR_SSH_AUTH_SOCK>",
        "SSH_PRIVATE_KEY_PATH": "<YOUR_SSH_PRIVATE_KEY_PATH>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_TIMEOUT": "<YOUR_SSH_TIMEOUT>",
        "SSH_COMMAND_TIMEOUT": "<YOUR_SSH_COMMAND_TIMEOUT>",
        "ENABLED_TOOLGROUPS": "<YOUR_ENABLED_TOOLGROUPS>",
        "SKIP_HEALTH_CHECKS": "<YOUR_SKIP_HEALTH_CHECKS>",
        "HEALTH_CHECK_TIMEOUT": "<YOUR_HEALTH_CHECK_TIMEOUT>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-agent-mcp-server",
        "-y"
      ],
      "env": {
        "SSH_HOST": "<YOUR_SSH_HOST>",
        "SSH_USERNAME": "<YOUR_SSH_USERNAME>",
        "SSH_PORT": "<YOUR_SSH_PORT>",
        "SSH_AUTH_SOCK": "<YOUR_SSH_AUTH_SOCK>",
        "SSH_PRIVATE_KEY_PATH": "<YOUR_SSH_PRIVATE_KEY_PATH>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_TIMEOUT": "<YOUR_SSH_TIMEOUT>",
        "SSH_COMMAND_TIMEOUT": "<YOUR_SSH_COMMAND_TIMEOUT>",
        "ENABLED_TOOLGROUPS": "<YOUR_ENABLED_TOOLGROUPS>",
        "SKIP_HEALTH_CHECKS": "<YOUR_SKIP_HEALTH_CHECKS>",
        "HEALTH_CHECK_TIMEOUT": "<YOUR_HEALTH_CHECK_TIMEOUT>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-agent-mcp-server",
        "-y"
      ],
      "env": {
        "SSH_HOST": "<YOUR_SSH_HOST>",
        "SSH_USERNAME": "<YOUR_SSH_USERNAME>",
        "SSH_PORT": "<YOUR_SSH_PORT>",
        "SSH_AUTH_SOCK": "<YOUR_SSH_AUTH_SOCK>",
        "SSH_PRIVATE_KEY_PATH": "<YOUR_SSH_PRIVATE_KEY_PATH>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_TIMEOUT": "<YOUR_SSH_TIMEOUT>",
        "SSH_COMMAND_TIMEOUT": "<YOUR_SSH_COMMAND_TIMEOUT>",
        "ENABLED_TOOLGROUPS": "<YOUR_ENABLED_TOOLGROUPS>",
        "SKIP_HEALTH_CHECKS": "<YOUR_SKIP_HEALTH_CHECKS>",
        "HEALTH_CHECK_TIMEOUT": "<YOUR_HEALTH_CHECK_TIMEOUT>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "ssh": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ssh-agent-mcp-server",
        "-y"
      ],
      "env": {
        "SSH_HOST": "<YOUR_SSH_HOST>",
        "SSH_USERNAME": "<YOUR_SSH_USERNAME>",
        "SSH_PORT": "<YOUR_SSH_PORT>",
        "SSH_AUTH_SOCK": "<YOUR_SSH_AUTH_SOCK>",
        "SSH_PRIVATE_KEY_PATH": "<YOUR_SSH_PRIVATE_KEY_PATH>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_TIMEOUT": "<YOUR_SSH_TIMEOUT>",
        "SSH_COMMAND_TIMEOUT": "<YOUR_SSH_COMMAND_TIMEOUT>",
        "ENABLED_TOOLGROUPS": "<YOUR_ENABLED_TOOLGROUPS>",
        "SKIP_HEALTH_CHECKS": "<YOUR_SKIP_HEALTH_CHECKS>",
        "HEALTH_CHECK_TIMEOUT": "<YOUR_HEALTH_CHECK_TIMEOUT>"
      }
    }
  }
}
Claude Code
claude mcp add ssh --env SSH_HOST=<YOUR_SSH_HOST> --env SSH_USERNAME=<YOUR_SSH_USERNAME> --env SSH_PORT=<YOUR_SSH_PORT> --env SSH_AUTH_SOCK=<YOUR_SSH_AUTH_SOCK> --env SSH_PRIVATE_KEY_PATH=<YOUR_SSH_PRIVATE_KEY_PATH> --env SSH_PASSPHRASE=<YOUR_SSH_PASSPHRASE> --env SSH_TIMEOUT=<YOUR_SSH_TIMEOUT> --env SSH_COMMAND_TIMEOUT=<YOUR_SSH_COMMAND_TIMEOUT> --env ENABLED_TOOLGROUPS=<YOUR_ENABLED_TOOLGROUPS> --env SKIP_HEALTH_CHECKS=<YOUR_SKIP_HEALTH_CHECKS> --env HEALTH_CHECK_TIMEOUT=<YOUR_HEALTH_CHECK_TIMEOUT> -- npx -y ssh-agent-mcp-server -y

Related MCP servers

MCP server for AppSignal — get alert details, search logs, and retrieve logs within time ranges.

View repository →

MCP server for AWS DynamoDB with fine-grained tool control and configurable access levels.

View repository →

MCP server for Fetch Pet insurance claims management using Playwright automation.

View repository →

MCP server for managing Fly.io machines, apps, logs, and Docker images.

View repository →

MCP server for Google Cloud Storage with fine-grained tool access control.

View repository →

MCP server for Gmail with OAuth2 (personal) and service account (Workspace) support.

View repository →