SSH MCP Server (hypnosis)

An SSH MCP server - a multitool that saves you and your AI agent time and tokens on debugging, development and server maintenance. Its 18 documented tools cover ssh, job, file, log. It runs locally over stdio via the published package.

People who work with ssh, job and file and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-10 · ★ 3 · #157 OF 945 MAINTAINED OTHER · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install SSH MCP Server (hypnosis)

before you install - you'll need

Set SSH_PROFILES_FILE before connecting.

Claude Code

claude mcp add hypnosis-ssh-mcp-server -- npx -y @hypnosis/ssh-mcp-server

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @hypnosis/ssh-mcp-server - published under the repo owner's npm scope (@hypnosis)

registry namespace io.github.hypnosis is GitHub-verified and matches the repo owner

03 · What SSH MCP Server (hypnosis) can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can run one command or a batch, with the destructive-command guard and optional detach, read one or several files, text or binary, write files with atomic rename and optional SHA-256 verification, and list a directory, with optional glob and recursion.

The 18 tools it gives your agent

Extracted from the project's README - what SSH MCP Server lets an agent do.

ssh_exec: - Run one command or a batch, with the destructive-command guard and optional detach
ssh_file_read: - Read one or several files, text or binary
ssh_file_write: - Write files with atomic rename and optional SHA-256 verification
ssh_file_list: - List a directory, with optional glob and recursion
ssh_upload: - Upload a file or directory over SSH, binary-safe with integrity checks; a directory replaces the target or merges into it
ssh_download: - Download a file or directory over SSH, binary-safe with integrity checks
ssh_job_status: - State of a background job: running, finished, or lost
ssh_job_output: - Read accumulated output from a byte offset
ssh_job_list: - List jobs, sweeping finished ones past their TTL
ssh_job_kill: - Signal a job's whole process group
ssh_log_tail: - Last N lines of one or several logs, glob supported; a container by name
ssh_log_search: - Pattern search across logs, or through a container's log

show all 18 tools

ssh_snapshot: - One-shot health snapshot: services, resources, Docker, network, errors
ssh_monitor: - Transport control: stats, reload, test, list, close
ssh_audit_baseline: - System, disk, memory, network, ssh, services, Docker, firewall, updates
ssh_tls_check: - Certificate expiry, SAN, chain and renewal hook for a domain
ssh_disk_breakdown: - Where the disk went: du top-N, Docker, journald, caches
ssh_service_status: - systemctl status plus a journalctl tail for one unit

Latest releases

v2.3.3 · 2026-08-24

Changes in 2.3.3 · See CHANGELOG.md for details. · Installation · bash · npm install -g @hypnosis/ssh-mcp-server · Or use with npx: · bash · npx @hypnosis/ssh-mcp-server

v2.3.1 · 2026-08-24

Changes in 2.3.1 · See CHANGELOG.md for details. · Installation · bash · npm install -g @hypnosis/ssh-mcp-server · Or use with npx: · bash · npx @hypnosis/ssh-mcp-server

v2.3.0 · 2026-08-21

Changes in 2.3.0 · See CHANGELOG.md for details. · Installation · bash · npm install -g @hypnosis/ssh-mcp-server · Or use with npx: · bash · npx @hypnosis/ssh-mcp-server

04 · Who maintains SSH MCP Server (hypnosis)

SSH MCP Server is maintained by hypnosis. We track 2 MCP servers from hypnosis - 2 actively maintained, 3 combined GitHub stars, oldest repo from Dec 2025.

05 · Facts

repository: github.com/hypnosis/ssh-mcp-server
website: https://github.com/hypnosis/ssh-mcp-server#readme
category: other - ranked #157 of 945 actively-maintained other servers as of 2026-09-18.
release cadence: 10+ releases in the last 90 days (latest 2026-08-24)
registry: io.github.hypnosis/ssh-mcp-server (active, first published 2026-08-18 · 9 versions)
packages: npm:@hypnosis/ssh-mcp-server

06 · SSH MCP Server (hypnosis) FAQ

Is SSH MCP Server (hypnosis) still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-10 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can SSH MCP Server (hypnosis) do?

How do I install SSH MCP Server (hypnosis)?

Run `npx -y @hypnosis/ssh-mcp-server`. The README documents one environment variable (SSH_PROFILES_FILE) to set first. Set SSH_PROFILES_FILE before connecting. You can also paste the ready-made client config above.

Does SSH MCP Server (hypnosis) run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to SSH MCP Server (hypnosis)

Alternatives to SSH MCP Server (hypnosis)

Maintained other servers if SSH MCP Server (hypnosis) isn't the fit.

More MCP servers to compare · Hadith DB · Gaff Check · Tidal MCP · Disney Lorcana TCG Collection · Ictbroadcast MCP

More TypeScript MCP servers · Server Tauri · Q Ring · Memex (iamtouchskyer) · Wso2 Docs MCP Server · see all