SSH MCP Server

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