SSH MCP Server

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/yawlabs-ssh-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

10 read · 4 write · 3 delete · 4 not yet classified

Secrets

None asked for

Install scripts

None found

Runs as

Node.js package

Tools (21)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• ssh_agent_ensure

  Ensure ssh-agent is running and reachable. Starts a new agent if needed and sets environment variables so subsequent SSH operations work. Use this FIRST when SSH operations fail with agent-related errors.

• ssh_config_lookupread-only

  Resolve the effective SSH configuration for a host. Shows hostname, user, port, identity files, proxy settings, and all other options from ~/.ssh/config. Use this to understand how SSH will connect to a host.

• ssh_deletecan change or delete data

  Description is built at runtime.

• ssh_diagnoseread-only

  Diagnose SSH connectivity issues. Checks ssh-agent status, loaded keys, known_hosts, SSH config, and attempts a test connection. Use this BEFORE attempting SSH operations if you suspect connectivity issues, or AFTER a failed SSH operation to understand why it failed.

• ssh_download

  Description is built at runtime.

• ssh_exec

  Execute a command on a remote host via SSH. The command is interpreted by the remote login shell — pipes, redirects, globs, and other shell metacharacters work as expected. Returns up to three content blocks in this order: the status (`[exit code: N]`, plus the signal and any truncation), then `[stderr]`, then `[stdout]`. Status comes first so a proxy that cuts long results (Yaw MCP keeps about 100 KB) never drops the exit code; for big output, filter or page on the remote (head, tail, grep). Use `env` to set environment variables for this call without modifying the command string. Subject to …

• ssh_findread-only

  Search for files on a remote host. Wraps the find command with structured parameters so you don't have to construct find syntax manually.

• ssh_git_check

  Test Git-over-SSH authentication to a hosting provider (GitHub, GitLab, Bitbucket, etc). Verifies your SSH key is registered and working. Use this when git clone/pull/push fails with SSH errors.

• ssh_key_listread-only

  List all SSH private keys in ~/.ssh/ with their type, fingerprint, and whether they are loaded in the agent. Use this to find which keys are available and which ones need to be loaded. Reports isError only when ~/.ssh exists but could not be read -- an absent or empty ~/.ssh is a successful answer with a ssh-keygen hint.

• ssh_key_load

  Load an SSH private key into the running agent. Ensures the agent is running first. Use this after ssh_key_list shows a key that is not loaded.

• ssh_known_hosts_fix

  Remove a stale host key from known_hosts and re-scan the host to add the current key. Use this when you see 'Host key verification failed' errors, typically after a server has been recreated or reprovisioned.

• ssh_lsread-only

  Description is built at runtime.

• ssh_mkdir

  Description is built at runtime.

• ssh_multi_exec

  Execute a command on multiple remote hosts in parallel. Runs at most SSH_MCP_MAX_POOL_SIZE hosts at once (default 100) and works through a longer list as slots free up. `timeout` is per host: it bounds each host's command, not the whole call. Each parallel slot works through its share of the list one host at a time, so with the pool to itself a call can take up to about ceil(hosts / SSH_MCP_MAX_POOL_SIZE) x (`timeout` + connect time). The connection pool is shared with every other tool; when it is full this call waits for slots instead of failing, and gives up only when none of its own hosts h…

• ssh_read_fileread-only

  Description is built at runtime.

Compare and alternatives

Featured in

• Best MCP servers for SSH

Signals

Stars

6

Forks

1

Open issues

0

Last commit

Oct 15, 2026 (13 days ago)

Last release

Oct 11, 2026 (17 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.YawLabs/ssh-mcp

Version

0.18.0

Auth

No auth

Packages

npm @yawlabs/ssh-mcp

License

MIT

Repository

github.com/YawLabs/ssh-mcp

Website

yaw.sh/mcp-servers/ssh-mcp/

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql