SSH MCP Server

SSH MCP Server

Production-ready MCP server enabling SSH commands, file transfers, and remote host management.

1
Stars
3
Forks
0
Releases

Overview

MCP SSH is a production-grade Model Context Protocol server that provides SSH capabilities and enterprise-grade tooling. It enables executing SSH commands, transferring files, listing configured hosts, and interactive guidance via an MCP prompt. The server exposes capabilities for background execution with process tracking, chunked output retrieval, command status queries, and graceful termination. File transfers use SCP with progress reporting, while security information can be retrieved to audit configuration. It emphasizes structured JSON output for programmatic integration, and supports speed and reliability improvements through connection reuse and optimized output management. Security is configurable with modes (blacklist/whitelist/disabled) and regex-based patterns for blocked or allowed commands, enabling strict policy enforcement. Timeout and timeout-related environment variables protect against hanging operations across connection, command execution, transfers, and read operations. The stack provides host discovery via ssh://hosts and interactive help via ssh_help, and is backed by a comprehensive test suite (107 tests, extensive QA). Development and deployment tooling rely on uv, with production-ready validation and performance optimizations.

Details

Owner
sinjab
Language
Python
License
MIT License
Updated
2025-12-07

Features

MCP Server

Execute SSH commands, transfer files, list hosts, and provide interactive help through MCP.

SSH Integration

Config parsing, encrypted keys, connection management, and file transfers.

Structured Output

Rich JSON schemas to enable programmatic integration.

Progress Tracking

Real-time progress reporting and detailed logging for operations.

Background Execution

All commands run in the background with per-command process tracking.

Timeout Protection

Comprehensive timeout handling to prevent hanging operations.

Security Controls

Configurable command validation with blacklist/whitelist patterns.

Performance Optimized

Connection reuse and output management optimizations.

Audience

DevOps EngineersAutomate SSH commands, background tasks, and file transfers across fleets in CI/CD and orchestration environments.
System AdministratorsSecure remote host management using SSH configuration, encrypted keys, and policy-based command validation.
Developers/QA EngineersTest and integrate MCP SSH features with structured output and progress tracking in development pipelines.

Tags

sshmcpbackground-executionfile-transferstructured-outputsecuritytimeouthost-managementscpblacklist-whitelistconfig-parsingprogress-tracking