Skip to main content

mcp-win-stdio-ssh

Advanced Multi-SSH Connection & Remote Management Model Context Protocol (MCP) Server for Windows & Claude Desktop / Claude Code CLI: 34 Tools for stateful SSH connection pooling, background execution, interactive PTYs, SFTP, and port tunnels. Zero mandatory environment variables (persists dynamically to ~/.mcp-win-stdio/ssh_hosts.json).

Part of the mcp-win-stdio suite.


🌟 Key Features

  • Multi-Host Connection Pooling & Persistence: Connect to unlimited remote servers. Automatically parses ~/.ssh/config (aliases, identity files, JumpHosts) and persists active host preferences.
  • Sticky Active Host: Run commands against an active default host or specify host="server_name" per tool call.
  • Remote Execution & Elevated Commands: Non-interactive command execution (ssh_exec), sudo password automation (ssh_exec_sudo), multi-line script execution (ssh_exec_script), and detached background jobs (ssh_exec_background).
  • Interactive PTY Shell Sessions: Start stateful pseudo-terminals (ssh_pty_start, ssh_pty_send, ssh_pty_read) for interactive REPLs, prompts, and long-running interactive tools.
  • Remote Diagnostics & Services: System health stats (ssh_system_overview), process monitoring (ssh_list_processes), systemd / docker / pm2 services (ssh_list_services, ssh_service_action), and live log tailing (ssh_tail_logs).
  • High-Performance SFTP: Explore remote file systems (sftp_list_dir), read/write files (sftp_read_file, sftp_write_file), inspect metadata (sftp_stat), and sync local/remote folders (sftp_upload, sftp_download).
  • Port Forwarding & Tunnels: Create background local-to-remote SSH port forwarding tunnels (ssh_tunnel_open, ssh_tunnel_list, ssh_tunnel_close) to securely access remote databases or web services.

📦 Installation

# Standalone package installation:
pip install mcp-win-stdio-ssh

# Or with full mcp-win-stdio suite:
pip install "mcp-win-stdio[all]"

🚀 Quick Start & Claude Configuration

Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json)

{
  "mcpServers": {
    "ssh": {
      "command": "mws-ssh",
      "args": ["run"]
    }
  }
}

Claude Code CLI

claude mcp add ssh mws-ssh run

🛠️ CLI Utilities

# Open interactive diagnostic CLI & host manager
mws-ssh

# List configured SSH hosts and test latency
mws-ssh test

# Launch MCP stdio server
mws-ssh run

# View comprehensive prompt recipes & tool documentation
mws-ssh guide

Metadata

Release files for mcp-win-stdio-ssh 0.4.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-win-stdio-ssh 0.4.3
File Size Uploaded Provenance Actions
mcp_win_stdio_ssh-0.4.3.tar.gz 25.5 kB Without provenance Details for mcp_win_stdio_ssh-0.4.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-win-stdio-ssh 0.4.3
File Interpreter ABI Platform Actions
mcp_win_stdio_ssh-0.4.3-py3-none-any.whl Python 3 none any Details for mcp_win_stdio_ssh-0.4.3-py3-none-any.whl

Total release size: 55.8 kB

Release files / mcp_win_stdio_ssh-0.4.3.tar.gz

Download URL mcp_win_stdio_ssh-0.4.3.tar.gz
Size 25.5 kB
Tags Source
SHA-256 checksum
How to use checksums
5e74444a7c5eae55b656976ac99404fa0c3dbef36f533141236c7499b94fb64b
BLAKE2b-256 checksum
How to use checksums
d17ab438a6dacbb3609fd3b67fcd4d1a82b8141513adac2fba3b0fd61edeab3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / mcp_win_stdio_ssh-0.4.3-py3-none-any.whl

Download URL mcp_win_stdio_ssh-0.4.3-py3-none-any.whl
Size 30.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c9aab143c4c873e9847e84237df7ad09232e362605fb2eb3be68da6d960cba87
BLAKE2b-256 checksum
How to use checksums
284d4d0a5dd25bdb79db772763d5928fbbdcd4df5b27b8a95207d4a00b5f30d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Security for mcp-win-stdio-ssh 0.4.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page