SSH

SSH

Agent for managing and controlling SSH connections.

37
Stars
10
Forks
1
Releases

Overview

The MCP SSH Agent is an MCP server that exposes SSH operations to MCP-compatible clients (such as Claude Desktop). It automatically discovers SSH hosts from ~/.ssh/config and ~/.ssh/known_hosts and executes commands using native ssh/scp tools for maximum reliability. The server runs as a Model Context Protocol server over STDIO, communicating clean JSON messages, and supports installation via npx, npm, or Claude Desktop extensions. It offers a defined set of tools, including listKnownHosts, runRemoteCommand, getHostInfo, checkConnectivity, uploadFile, downloadFile, and runCommandBatch, enabling listing hosts, executing remote commands,/transferring files, and batching commands. The agent fully processes SSH Include directives and handles related config scenarios, including a bug warning about Include placement, ensuring host discovery remains reliable. It relies on standard SSH authentication methods (SSH agent and key-based) and uses the system's ssh/scp clients to honor user configurations. Advanced usage is facilitated by environment variables (e.g., MCP_SILENT) and developer-friendly installation options. The README also describes Claude Desktop integration and practical usage scenarios like listing hosts, connectivity checks, and file transfers.

Details

Owner
AiondaDotCom
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

Reliable SSH

Uses native ssh and scp commands instead of JavaScript SSH libraries for maximum reliability.

Automatic Discovery

Finds hosts from ~/.ssh/config and ~/.ssh/known_hosts for seamless host availability.

Full SSH Support

Works with SSH agents, keys, and all authentication methods.

File Operations

Upload and download files using scp.

Batch Commands

Execute multiple commands in sequence.

Error Handling

Comprehensive error reporting with timeouts.

Audience

IT Administrators / DevOpsUse MCP-SSH to manage and automate SSH connections and operations via Claude Desktop and other MCP clients.
AI-assisted developers / power usersLeverage AI assistants to list hosts, connect to servers, run commands, and transfer files using MCP-SSH.

Tags

SSHMCPClaude DesktopSSH configknown_hostsscpInclude directivesSSH agenthost discoveryremote commands