SSH MCP Server
Run commands, move files, search logs and audit machines over SSH from your agent.
Ads
Overview
It uses the OpenSSH client already on your machine: your keys, your ~/.ssh/config, your jump hosts, your agent forwarding. Nothing bundled, nothing to compile, no native bindings. Works with Claude Code, Codex CLI, Cline, opencode, Gemini CLI, Qwen Code, Hermes and other MCP clients. Install · Tools · Setup · Security · Roadmap · Docs · Changelog No global installation required. npx downloads the package on first use: Add it to your MCP client — Claude Code, for example — for every project: Or write it by hand — the same server in the config shape most clients share:
Installation
npx -y @hypnosis/ssh-mcp-server
Configuration
{
"mcpServers": {
"ssh": {
"command": "npx",
"args": ["-y", "@hypnosis/ssh-mcp-server"],
"env": {
"SSH_PROFILES_FILE": "~/.claude/ssh-profiles.json"
}
}Capabilities
- Run commands with safety guardrails
Ask your assistant to execute single or batched commands via `ssh_exec`, with destructive-command protection that blocks irreversible operations before they reach the server.
- Read, write, and list remote files
Use `ssh_file_read`, `ssh_file_write`, and `ssh_file_list` to inspect or modify files, with atomic writes and optional SHA-256 verification.
- Search logs and check server health
Query `ssh_log_search` or `ssh_log_tail` across files and containers, or get a structured health snapshot with `ssh_snapshot` and `ssh_audit_baseline`.
- Transfer files with integrity checks
Upload or download files and directories via `ssh_upload` and `ssh_download`, with automatic legacy scp fallback for older devices.
- Manage long-running background jobs
Detach slow operations with `ssh_exec` and track them via `ssh_job_status`, `ssh_job_output`, and `ssh_job_kill`, surviving disconnects.
Tags
- ssh
- devops-infrastructure
- serverless
Related MCP servers
Context7 MCP
OfficialOfficial Context7 MCP server that brings up-to-date, version-specific library documentation and code examples into AI coding prompts.
Chrome DevTools MCP
OfficialOfficial Chrome DevTools MCP server for controlling and inspecting a live Chrome browser from coding agents such as Gemini, Claude, Cursor, and Copilot.
Mastra/mcp
OfficialClient implementation for Mastra, providing seamless integration with MCP-compatible AI models and tools.
GitHub MCP Server
OfficialConnect your AI assistant to GitHub repositories, issues, pull requests, and search.