mcp-win-stdio-ssh 0.2.4__tar.gz

mcp_win_stdio_ssh-0.2.4/.gitignore

@@ -0,0 +1,60 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+*.manifest
+*.spec
+
+pip-log.txt
+pip-delete-this-directory.txt
+pypi api.txt
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+*.mo
+*.pot
+
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+.idea/
+.vscode/
+*.swp
+*.swo
+
+*.log

mcp_win_stdio_ssh-0.2.4/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.5
+Name: mcp-win-stdio-ssh
+Version: 0.2.4
+Summary: Advanced Multi-SSH Connection & Remote Management Model Context Protocol (MCP) server for Windows & Claude: 25+ tools for multi-host pooling, ~/.ssh/config auto-discovery, PTY interactive shells, SFTP file management, systemd/docker services, background jobs, and local port forwarding tunnels.
+Author: Mohan Kumar Indala
+License-Expression: MIT
+Keywords: ai,claude,docker,llm,mcp,port-forwarding,pty,remote-management,sftp,ssh,systemd,tunnels,windows
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Requires-Dist: cryptography>=3.3.0
+Requires-Dist: mcp-win-stdio>=0.2.4
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: paramiko>=3.0.0
+Description-Content-Type: text/markdown
+
+# mcp-win-stdio-ssh
+
+> Advanced Multi-SSH Connection & Remote Management Model Context Protocol (MCP) Server for Windows & Claude Desktop / Claude Code CLI.
+
+Part of the **[mcp-win-stdio](https://github.com/indala/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
+
+```bash
+# 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`)
+
+```json
+{
+  "mcpServers": {
+    "ssh": {
+      "command": "mws-ssh",
+      "args": ["run"]
+    }
+  }
+}
+```
+
+### Claude Code CLI
+
+```bash
+claude mcp add ssh mws-ssh run
+```
+
+---
+
+## 🛠️ CLI Utilities
+
+```bash
+# 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
+```

mcp_win_stdio_ssh-0.2.4/README.md

@@ -0,0 +1,70 @@
+# mcp-win-stdio-ssh
+
+> Advanced Multi-SSH Connection & Remote Management Model Context Protocol (MCP) Server for Windows & Claude Desktop / Claude Code CLI.
+
+Part of the **[mcp-win-stdio](https://github.com/indala/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
+
+```bash
+# 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`)
+
+```json
+{
+  "mcpServers": {
+    "ssh": {
+      "command": "mws-ssh",
+      "args": ["run"]
+    }
+  }
+}
+```
+
+### Claude Code CLI
+
+```bash
+claude mcp add ssh mws-ssh run
+```
+
+---
+
+## 🛠️ CLI Utilities
+
+```bash
+# 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
+```

mcp_win_stdio_ssh-0.2.4/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mcp-win-stdio-ssh"
+version = "0.2.4"
+description = "Advanced Multi-SSH Connection & Remote Management Model Context Protocol (MCP) server for Windows & Claude: 25+ tools for multi-host pooling, ~/.ssh/config auto-discovery, PTY interactive shells, SFTP file management, systemd/docker services, background jobs, and local port forwarding tunnels."
+readme = "README.md"
+
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "Mohan Kumar Indala" }
+]
+keywords = ["mcp", "claude", "ssh", "sftp", "pty", "tunnels", "port-forwarding", "remote-management", "systemd", "docker", "ai", "llm", "windows"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Win32 (MS Windows)",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: System :: Systems Administration",
+]
+
+dependencies = [
+    "mcp-win-stdio>=0.2.4",
+    "mcp>=1.2.0",
+    "paramiko>=3.0.0",
+    "cryptography>=3.3.0",
+]
+
+[project.scripts]
+mcp-win-stdio-ssh = "mcp_win_stdio.ssh.cli:main"
+mws-ssh = "mcp_win_stdio.ssh.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_win_stdio"]

mcp_win_stdio_ssh-0.2.4/src/mcp_win_stdio/ssh/__init__.py

@@ -0,0 +1,5 @@
+"""
+Advanced Multi-SSH Connection & Remote Management MCP Server for mcp-win-stdio.
+"""
+
+__version__ = "0.2.4"

mcp_win_stdio_ssh-0.2.4/src/mcp_win_stdio/ssh/__main__.py

@@ -0,0 +1,8 @@
+"""
+Direct execution entrypoint: python -m mcp_win_stdio.ssh
+"""
+
+from mcp_win_stdio.ssh.server import mcp
+
+if __name__ == "__main__":
+    mcp.run(transport="stdio")

mcp_win_stdio_ssh-0.2.4/src/mcp_win_stdio/ssh/cli.py

@@ -0,0 +1,152 @@
+"""
+CLI entry point for mcp-win-stdio-ssh.
+"""
+
+import argparse
+import os
+from pathlib import Path
+import shutil
+import subprocess
+import sys
+import time
+
+# Ensure Windows console uses UTF-8 without crashing on cp1252
+if sys.platform == "win32":
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+        sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+    except Exception:
+        pass
+
+from mcp_win_stdio.ssh import __version__
+from mcp_win_stdio.ssh.connection import (
+    SYSTEM_SSH_CONFIG,
+    get_all_registered_hosts,
+    get_active_host_name,
+    resolve_host_info,
+    get_cached_or_connect,
+)
+from mcp_win_stdio.ssh.guide import print_ssh_guide
+from mcp_win_stdio.ssh.server import mcp
+
+
+def cmd_run(args: argparse.Namespace) -> None:
+    """Run SSH MCP server over stdio."""
+    mcp.run()
+
+
+def cmd_doctor(args: argparse.Namespace) -> None:
+    """Run diagnostic checks on SSH drivers, Windows OpenSSH service, keys, and configs."""
+    print(f"\n=== mcp-win-stdio-ssh Doctor Diagnostic (v{__version__}) ===\n")
+    print(f"[OK] Python Runtime: {sys.version.split()[0]} ({sys.executable})")
+
+    # 1. Driver Checks
+    for dep in ("mcp", "paramiko", "cryptography"):
+        try:
+            mod = __import__(dep)
+            ver = getattr(mod, "__version__", "installed")
+            print(f"[OK] Python Module: {dep:<14} (v{ver})")
+        except ImportError:
+            print(f"[FAIL] Python Module: {dep:<14} (MISSING - run `pip install {dep}`)")
+
+    # 2. OpenSSH Windows client check
+    ssh_bin = shutil.which("ssh")
+    if ssh_bin:
+        print(f"[OK] System SSH CLI: {ssh_bin}")
+    else:
+        print(f"[INFO] System SSH CLI: Not on PATH (Optional: Paramiko native SSH client active)")
+
+    # 3. SSH Config & Keys
+    ssh_dir = Path.home() / ".ssh"
+    if ssh_dir.is_dir():
+        print(f"[OK] SSH Directory: {ssh_dir}")
+        if SYSTEM_SSH_CONFIG.exists():
+            print(f"[OK] SSH Config:    {SYSTEM_SSH_CONFIG}")
+        else:
+            print(f"[INFO] SSH Config:   No ~/.ssh/config found (can use add_host or create config)")
+
+        keys = [f.name for f in ssh_dir.iterdir() if f.is_file() and not f.name.endswith(".pub") and "id_" in f.name]
+        if keys:
+            print(f"[OK] Found Keys:     {', '.join(keys)}")
+        else:
+            print(f"[INFO] Found Keys:    No default id_* keys found in ~/.ssh/")
+    else:
+        print(f"[INFO] SSH Directory: {ssh_dir} not created yet.")
+
+    # 4. Registered Hosts
+    hosts = get_all_registered_hosts()
+    active = get_active_host_name()
+    print(f"\n--- Registered Hosts ({len(hosts)}) ---")
+    for name, h in hosts.items():
+        is_act = " (ACTIVE DEFAULT)" if name == active else ""
+        print(f" • {name:<16} -> {h.get('user')}@{h.get('hostname')}:{h.get('port')} [{h.get('source')}]{is_act}")
+
+    print("\nDiagnostic complete.\n")
+
+
+def cmd_test(args: argparse.Namespace) -> None:
+    """Test SSH connectivity and latency to configured hosts."""
+    target = args.host
+    hosts = get_all_registered_hosts()
+
+    if not hosts and not target:
+        print("\n[!] No SSH hosts configured. Use 'add_host' tool or configure ~/.ssh/config.\n")
+        return
+
+    targets = [target] if target else list(hosts.keys())
+
+    print(f"\n=== Testing SSH Connectivity ({len(targets)} host{'s' if len(targets) > 1 else ''}) ===\n")
+
+    for h_name in targets:
+        try:
+            h_info = resolve_host_info(h_name)
+            t_start = time.time()
+            client = get_cached_or_connect(h_info["name"], timeout=10)
+            lat_ms = round((time.time() - t_start) * 1000, 2)
+
+            stdin, stdout, stderr = client.exec_command("uname -srmo 2>/dev/null || ver", timeout=5)
+            os_info = stdout.read().decode("utf-8", errors="replace").strip()
+
+            print(f" [OK] {h_name:<16} -> {h_info.get('user')}@{h_info.get('hostname')}:{h_info.get('port')} ({lat_ms}ms) | {os_info}")
+        except Exception as e:
+            print(f" [FAIL] {h_name:<14} -> Error: {e}")
+
+    print("\nTest complete.\n")
+
+
+def cmd_guide(args: argparse.Namespace) -> None:
+    """Print guide and prompt recipes."""
+    print_ssh_guide()
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="mcp-win-stdio-ssh",
+        description="Unified Multi-SSH Connection & Remote Management MCP Server CLI",
+    )
+    parser.add_argument("--version", "-v", action="version", version=f"%(prog)s {__version__}")
+    subparsers = parser.add_subparsers(dest="command", help="Command to execute")
+
+    sub_guide = subparsers.add_parser("guide", help="View usage guide and recipes")
+    sub_guide.set_defaults(func=cmd_guide)
+
+    sub_doctor = subparsers.add_parser("doctor", help="Check SSH configuration and drivers")
+    sub_doctor.set_defaults(func=cmd_doctor)
+
+    sub_test = subparsers.add_parser("test", help="Test connectivity to configured hosts")
+    sub_test.add_argument("host", nargs="?", help="Specific host name to test")
+    sub_test.set_defaults(func=cmd_test)
+
+    sub_run = subparsers.add_parser("run", help="Run SSH MCP server over stdio")
+    sub_run.set_defaults(func=cmd_run)
+
+    args = parser.parse_args()
+    if hasattr(args, "func"):
+        args.func(args)
+    else:
+        # Default action is run
+        cmd_run(args)
+
+
+if __name__ == "__main__":
+    main()