MCP.so
Sign In

SSH MCP Server

@KinoThe-Kafkaesque

Repository

About SSH MCP Server

this is a collection of tools that allows your agent to execute commands on your remote servers

Basic information

Category

Developer Tools

License

MIT

Runtime

node

Transports

stdio

Publisher

KinoThe-Kafkaesque

Config

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

{
  "mcpServers": {
    "ssh-mcp-server-kinothe-kafkaesque": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@KinoThe-Kafkaesque/ssh-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

7

save `{ "name", "host", "username", "privateKeyPath" }`.

list stored credential records.

delete `{ "name" }`.

run a shell command with `{ "credentialName", "command", "timeout" }`.

run an argv-style command array, for example `{ "credentialName": "prod", "command": ["grep", "-E", "foo|bar", "/var/log/app.log"] }`.

copy one file over SFTP with `{ "credentialName", "localPath", "remotePath", "direction" }`.

copy directories or larger trees with rsync and the same transfer shape.

Overview

What is SSH MCP Server?

A Model Context Protocol (MCP) server implementation that provides SSH capabilities for secure remote access and execution. It integrates with SQLite for credential storage and is built with TypeScript. This server is aimed at developers who need to control remote machines through the MCP protocol.

How to use SSH MCP Server?

Install via Smithery (npx -y @smithery/cli install @KinoThe-Kafkaesque/ssh-mcp-server --client claude) or manually: clone the repo, run npm install, npm run build, then npm start. Start the server, then call its tools (e.g., ssh_exec, scp_copy, ssh_tunnel_start) with stored credentials. Credentials are managed through add_credential, list_credentials, remove_credential tools.

Key features of SSH MCP Server

  • SSH server implementation using MCP protocol
  • SQLite database for persistent credential storage
  • Named credential management
  • Remote shell command execution with timeout
  • SCP and rsync file transfer support
  • Interactive SSH session management
  • Local and remote port forwarding tunnels

Use cases of SSH MCP Server

  • Run shell commands on remote servers from an MCP client (e.g., Claude Desktop)
  • Transfer files between local and remote machines via SCP or rsync
  • Maintain interactive SSH sessions programmatically
  • Set up secure port forwarding tunnels for service access

FAQ from SSH MCP Server

What are the prerequisites for running SSH MCP Server?

Node.js 18 or higher, a package manager (npm or yarn), and TypeScript knowledge for development.

How are SSH credentials stored?

Credentials are stored in a SQLite database file (ssh.db), which is created automatically when the server starts.

What tools does SSH MCP Server provide for remote execution?

It provides ssh_exec (single command with timeout), ssh_exec_raw (argv-style command array), scp_copy, rsync_copy, and interactive session tools

Comments

More Developer Tools MCP servers

Grafana MCP server

grafana

MCP server for Grafana

3.2K

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

MCP Framework

QuantGeekDev

The Typescript MCP Framework

924

Test

x1xhlol

FULL Augment Code, Claude Code, Cluely, CodeBuddy, Comet, Cursor, Devin AI, Junie, Kiro, Leap.new, Lovable, Manus, NotionAI, Orchids.app, Perplexity, Poke, Qoder, Replit, Same.dev, Trae, Traycer AI, VSCode Agent, Warp.dev, Windsurf, Xcode, Z.ai Code, Dia & v0. (And other Open Sou

141.7K

Hello World MCP Server (Reference Extension)

anthropics

Desktop Extensions: One-click local MCP server installation in desktop apps

2.0K