🔐 ssh-mcp-server

Name: 🔐 ssh-mcp-server
Author: classfang

@classfang

Repository

About 🔐 ssh-mcp-server

基于 SSH 的 MCP 服务 🧙‍♀️。已被MCP官方收录 🎉。 SSH MCP Server 🧙‍♀️. It has been included in the community MCP repository 🎉.

Basic information

Config

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

{
  "mcpServers": {
    "ssh-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "192.168.1.1",
        "--port",
        "22",
        "--username",
        "root",
        "--password",
        "pwd123456"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 🔐 ssh-mcp-server?

🔐 ssh-mcp-server is a Model Context Protocol (MCP) server that enables AI assistants and other MCP-compatible applications to execute remote SSH commands through a standardized interface. It acts as a secure bridge, allowing AI models to operate remote servers without directly exposing SSH credentials.

How to use 🔐 ssh-mcp-server?

It can be run directly via npx without global installation. Configuration is done in your MCP client's mcp.json file, passing arguments such as --host, --port, --username, and authentication method (--password, --privateKey, or --passphrase). Multiple connection profiles, command restrictions, transport modes, and MFA support are configured through additional CLI arguments or a JSON config file.

Key features of 🔐 ssh-mcp-server

Supports password and private key (with passphrase) authentication
Whitelist and blacklist patterns for command security control
Complies with MCP protocol for seamless AI integration
Dual transport modes: exec and shell for bastion/jump hosts
Bidirectional file transfer (upload and download)
Credentials managed locally, never exposed to AI models

Use cases of 🔐 ssh-mcp-server

AI assistant executing remote server commands (e.g., system inspection, log reading)
Securely managing servers through MCP clients with command restrictions
Connecting to bastion/jump hosts or devices that require an interactive shell
Multi-server management via a single MCP server configuration
Automated file transfers between local and remote machines

FAQ from 🔐 ssh-mcp-server

What authentication methods are supported?

Password authentication, private key authentication, and private key with passphrase are supported. The server can also reuse entries from ~/.ssh/config.

How can I restrict which commands can be executed?

Use --whitelist to allow only commands matching specified patterns, or --blacklist to block dangerous commands. Both accept comma-separated regular expressions.

What is the difference between `exec` and `shell` transport modes?

exec mode supports command execution, upload, and download. shell mode runs commands through a persistent shell session (useful for bastion hosts) but does not support file transfers (upload/download).

How do I handle MFA (multi-factor authentication) on the SSH server?

Enable --try-keyboard and set the environment variable SSH_MCP_2FA_CODE before connecting. The server will supply password and private key automatically, then prompt for the 2FA code.

What tools does this server provide?

It provides four tools: execute-command (run commands), upload (upload files), download (download files), and list-servers (list configured SSH connections).

Comments

More Developer Tools MCP servers

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K

MCP Containers

metorial

Connect any AI model to 1200+ integrations (MCP, CLI, API)

3.3K

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K