Advertise
MCP.so
Sign In

MCP SSH Agent

@AiondaDotCom

Repository

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

AiondaDotCom

Submitted by

Stephan Ferraro

About MCP SSH Agent

A Model Context Protocol (MCP) server for managing and controlling SSH connections.

#linux#ssh#mcp

MCP SSH Agent config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-ssh": {
      "command": "/path/mcp-ssh/start.sh"
    }
  }
}

MCP SSH Agent tools

7

Returns a consolidated list of all known SSH hosts, prioritizing ~/.ssh/config entries first, then additional hosts from ~/.ssh/known_hosts

Executes a shell command on an SSH host

Returns all configuration details for an SSH host

Checks if an SSH connection to the host is possible

Uploads a local file to an SSH host

Downloads a file from an SSH host

Executes multiple shell commands sequentially on an SSH host

Overview

What is MCP SSH Agent?

A Model Context Protocol (MCP) server for managing and controlling SSH connections. It integrates seamlessly with Claude Desktop and other MCP-compatible clients to provide AI-powered SSH operations, automatically discovering hosts from ~/.ssh/config and ~/.ssh/known_hosts and executing commands using native SSH tools.

How to use MCP SSH Agent?

Install via the Desktop Extension (.dxt) file by double-clicking it, or run npx @aiondadotcom/mcp-ssh after adding the server configuration to Claude Desktop’s MCP settings file (e.g., ~/Library/Application Support/Claude/claude_desktop_config.json). Once configured, ask Claude to perform SSH tasks like listing hosts, running commands, or transferring files.

Key features of MCP SSH Agent

  • Uses native ssh/scp commands for reliability
  • Automatic host discovery from SSH config and known_hosts
  • Supports SSH agents, keys, and all authentication methods
  • Password authentication via @password annotation (local only)
  • File upload and download operations
  • Batch command execution with error handling and timeouts

Use cases of MCP SSH Agent

  • List all configured SSH hosts and their details
  • Check SSH connectivity to a remote server
  • Execute remote commands or run multiple commands sequentially
  • Upload or download files to/from remote hosts
  • Manage servers with jump hosts, custom ports, and different authentication methods

Frequently asked questions

1

What are the runtime requirements?

Node.js 20 or higher, plus an SSH client with `ssh` and `scp` commands available on the system.

2

How does password authentication work?

Store passwords in `~/.ssh/config` using `# @password:yourPassword` annotations. The password is read locally by the MCP server and never sent to the AI model or any cloud provider. The SSH config file must have `600` permissions.

3

Does it support SSH Include directives?

Yes. The MCP SSH Agent correctly processes `Include` directives regardless of their placement, whereas SSH itself has a bug requiring them at the beginning of the file.

4

What transport protocol does the server use?

The server communicates over STDIO using clean JSON messages, making it compatible with MCP clients like Claude Desktop.

5

What authentication methods are supported?

All standard SSH authentication methods: keys, SSH agent, and password-based login (including key passphrases) stored in the config file.

Comments

More Developer Tools MCP servers

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

1

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

1

Termany

thinkany-ai

Agent-Native Terminal

174

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U

1

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

3
Advertise