claude-ssh-mcp 1.0.0__py3-none-any.whl

claude_ssh_mcp/__init__.py

@@ -0,0 +1,237 @@
+#!/usr/bin/env python3
+"""
+claude-ssh-mcp - MCP addon for Claude Desktop providing SSH capabilities.
+
+This package automatically installs Node.js and runs the npm package.
+"""
+
+import os
+import sys
+import subprocess
+import shutil
+import platform
+import urllib.request
+import tarfile
+import zipfile
+import tempfile
+from pathlib import Path
+
+__version__ = "1.0.0"
+
+# Node.js version to install if not found
+NODE_VERSION = "20.11.0"
+
+def get_node_paths():
+    """Get paths where Node.js might be installed."""
+    home = Path.home()
+    paths = []
+
+    if platform.system() == "Windows":
+        paths = [
+            home / ".claude-ssh-mcp" / "node",
+            Path(os.environ.get("PROGRAMFILES", "C:\\Program Files")) / "nodejs",
+            Path(os.environ.get("LOCALAPPDATA", "")) / "Programs" / "node",
+        ]
+    else:
+        paths = [
+            home / ".claude-ssh-mcp" / "node",
+            Path("/usr/local/bin"),
+            Path("/usr/bin"),
+            home / ".local" / "bin",
+            home / ".nvm" / "versions" / "node" / f"v{NODE_VERSION}" / "bin",
+        ]
+
+    return paths
+
+
+def find_node():
+    """Find Node.js executable."""
+    # Check if node is in PATH
+    node_cmd = "node.exe" if platform.system() == "Windows" else "node"
+    node_path = shutil.which(node_cmd)
+    if node_path:
+        return node_path
+
+    # Check common installation paths
+    for base_path in get_node_paths():
+        if platform.system() == "Windows":
+            node_exe = base_path / "node.exe"
+        else:
+            node_exe = base_path / "node"
+
+        if node_exe.exists():
+            return str(node_exe)
+
+    return None
+
+
+def find_npx():
+    """Find npx executable."""
+    npx_cmd = "npx.cmd" if platform.system() == "Windows" else "npx"
+    npx_path = shutil.which(npx_cmd)
+    if npx_path:
+        return npx_path
+
+    # Check relative to node
+    node_path = find_node()
+    if node_path:
+        node_dir = Path(node_path).parent
+        if platform.system() == "Windows":
+            npx_exe = node_dir / "npx.cmd"
+        else:
+            npx_exe = node_dir / "npx"
+
+        if npx_exe.exists():
+            return str(npx_exe)
+
+    return None
+
+
+def get_node_download_url():
+    """Get the Node.js download URL for the current platform."""
+    system = platform.system().lower()
+    machine = platform.machine().lower()
+
+    if machine in ("x86_64", "amd64"):
+        arch = "x64"
+    elif machine in ("arm64", "aarch64"):
+        arch = "arm64"
+    elif machine in ("i386", "i686", "x86"):
+        arch = "x86"
+    else:
+        arch = "x64"  # Default
+
+    if system == "windows":
+        return f"https://nodejs.org/dist/v{NODE_VERSION}/node-v{NODE_VERSION}-win-{arch}.zip"
+    elif system == "darwin":
+        return f"https://nodejs.org/dist/v{NODE_VERSION}/node-v{NODE_VERSION}-darwin-{arch}.tar.gz"
+    else:  # Linux
+        return f"https://nodejs.org/dist/v{NODE_VERSION}/node-v{NODE_VERSION}-linux-{arch}.tar.xz"
+
+
+def install_nodejs():
+    """Download and install Node.js."""
+    install_dir = Path.home() / ".claude-ssh-mcp" / "node"
+    install_dir.mkdir(parents=True, exist_ok=True)
+
+    url = get_node_download_url()
+    print(f"Downloading Node.js from {url}...")
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        tmpdir = Path(tmpdir)
+
+        # Download
+        if url.endswith(".zip"):
+            archive_path = tmpdir / "node.zip"
+        elif url.endswith(".tar.xz"):
+            archive_path = tmpdir / "node.tar.xz"
+        else:
+            archive_path = tmpdir / "node.tar.gz"
+
+        urllib.request.urlretrieve(url, archive_path)
+        print("Extracting...")
+
+        # Extract
+        if url.endswith(".zip"):
+            with zipfile.ZipFile(archive_path, 'r') as zf:
+                zf.extractall(tmpdir)
+        elif url.endswith(".tar.xz"):
+            import lzma
+            with lzma.open(archive_path) as xz:
+                with tarfile.open(fileobj=xz) as tar:
+                    tar.extractall(tmpdir)
+        else:
+            with tarfile.open(archive_path, "r:gz") as tar:
+                tar.extractall(tmpdir)
+
+        # Find extracted directory
+        extracted = None
+        for item in tmpdir.iterdir():
+            if item.is_dir() and item.name.startswith("node-"):
+                extracted = item
+                break
+
+        if not extracted:
+            raise RuntimeError("Failed to find extracted Node.js directory")
+
+        # Move to install location
+        if platform.system() == "Windows":
+            # On Windows, copy the contents directly
+            for item in extracted.iterdir():
+                dest = install_dir / item.name
+                if dest.exists():
+                    if dest.is_dir():
+                        shutil.rmtree(dest)
+                    else:
+                        dest.unlink()
+                shutil.move(str(item), str(dest))
+        else:
+            # On Unix, copy bin, lib, etc.
+            for item in extracted.iterdir():
+                dest = install_dir / item.name
+                if dest.exists():
+                    if dest.is_dir():
+                        shutil.rmtree(dest)
+                    else:
+                        dest.unlink()
+                shutil.move(str(item), str(dest))
+
+    # Verify installation
+    if platform.system() == "Windows":
+        node_exe = install_dir / "node.exe"
+    else:
+        node_exe = install_dir / "bin" / "node"
+
+    if not node_exe.exists():
+        raise RuntimeError(f"Node.js installation failed - {node_exe} not found")
+
+    print(f"Node.js installed to {install_dir}")
+    return str(node_exe)
+
+
+def ensure_nodejs():
+    """Ensure Node.js is installed, installing it if necessary."""
+    node_path = find_node()
+    if node_path:
+        return node_path
+
+    print("Node.js not found. Installing...")
+    return install_nodejs()
+
+
+def run_npx(*args):
+    """Run npx with the given arguments."""
+    npx_path = find_npx()
+
+    if not npx_path:
+        # Ensure Node.js is installed
+        node_path = ensure_nodejs()
+        node_dir = Path(node_path).parent
+
+        if platform.system() == "Windows":
+            npx_path = str(node_dir / "npx.cmd")
+        else:
+            npx_path = str(node_dir / "npx")
+
+    # Run npx
+    cmd = [npx_path] + list(args)
+    return subprocess.call(cmd)
+
+
+def main():
+    """Main entry point."""
+    # Ensure Node.js is available
+    ensure_nodejs()
+
+    # Run the npm package
+    sys.exit(run_npx("-y", "claude-ssh-mcp"))
+
+
+def install():
+    """Install command - adds to Claude Desktop config."""
+    ensure_nodejs()
+    sys.exit(run_npx("-y", "claude-ssh-mcp"))
+
+
+if __name__ == "__main__":
+    main()

claude_ssh_mcp-1.0.0.dist-info/METADATA

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: claude-ssh-mcp
+Version: 1.0.0
+Summary: MCP addon for Claude Desktop - SSH into servers, run commands, transfer files
+Author-email: MaraBank <mb08112009@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/MaraBank/mcp-ssh-server
+Project-URL: Repository, https://github.com/MaraBank/mcp-ssh-server
+Project-URL: Issues, https://github.com/MaraBank/mcp-ssh-server/issues
+Keywords: mcp,ssh,claude,claude-desktop,sftp,remote,server
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# claude-ssh-mcp
+
+[![PyPI version](https://img.shields.io/pypi/v/claude-ssh-mcp.svg)](https://pypi.org/project/claude-ssh-mcp/)
+[![npm version](https://img.shields.io/npm/v/claude-ssh-mcp.svg)](https://www.npmjs.com/package/claude-ssh-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+MCP addon for **Claude Desktop** — gives Claude SSH access to your servers.
+
+## Install
+
+**With pip (auto-installs Node.js if needed):**
+
+```bash
+pip install claude-ssh-mcp
+claude-ssh-mcp
+```
+
+**Or with npm (if you have Node.js):**
+
+```bash
+npx -y claude-ssh-mcp
+```
+
+That's it. Restart Claude Desktop and you're ready.
+
+## Usage
+
+Just talk to Claude naturally:
+
+- *"Connect to 185.91.118.4 as root with password mypass, call it production"*
+- *"Run `ls -la /var/www` on production"*
+- *"Upload C:\Users\me\app.zip to /tmp/app.zip on production"*
+- *"Download /var/log/error.log from production"*
+- *"Connect to 10.0.0.5 as deploy with key at C:\Users\me\.ssh\id_rsa, name it staging"*
+- *"Transfer /var/log/app.log from production to /tmp/app.log on staging"*
+- *"List my servers"*
+- *"Remove staging"*
+
+## Features
+
+- **Auto-install** — one command adds it to Claude Desktop
+- **Auto-installs Node.js** — pip version handles everything
+- **Servers are saved** — connect once, reconnect by name
+- **SSH keepalive** — connections stay alive during long sessions
+- **Auto-reconnect** — recovers from network interruptions
+- **Auto-update** — checks for updates every 2 hours
+
+## Saved Servers
+
+When you tell Claude to connect, the server is saved to `~/.mcp-ssh/servers.json`. Next time just say *"connect to production"*.
+
+Edit manually if you prefer:
+
+```json
+{
+  "production": {
+    "host": "185.91.118.4",
+    "port": 22,
+    "username": "root",
+    "password": "mypass"
+  },
+  "staging": {
+    "host": "10.0.0.5",
+    "port": 22,
+    "username": "deploy",
+    "privateKeyPath": "C:\\Users\\me\\.ssh\\id_rsa"
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does |
+|------|--------------|
+| `ssh_connect` | Connect to a server (new or saved) |
+| `ssh_disconnect` | Close a connection |
+| `ssh_list_sessions` | Show all connections and saved servers |
+| `ssh_remove_server` | Delete a saved server |
+| `ssh_execute` | Run a shell command |
+| `ssh_upload` | Upload a local file (SFTP) |
+| `ssh_download` | Download a remote file (SFTP) |
+| `ssh_transfer` | Copy a file between two servers |
+| `ssh_list_files` | List remote directory contents |
+
+## License
+
+MIT — free and open source.

claude_ssh_mcp-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+claude_ssh_mcp/__init__.py,sha256=klN6MQI6WPTxvqI0IzXoMHotqItBB15cpj9BG9vLE5o,6663
+claude_ssh_mcp-1.0.0.dist-info/licenses/LICENSE,sha256=wFclISLKRFSih_TFiMzSwthYku2whTPgUd_sJ6DWarE,1065
+claude_ssh_mcp-1.0.0.dist-info/METADATA,sha256=7RRfMn2hkz5vwOKiOm3I_SewC1ldK11gJks3zEhBFFk,3603
+claude_ssh_mcp-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+claude_ssh_mcp-1.0.0.dist-info/entry_points.txt,sha256=oheaU_3JumlDh127EFyhFHWC65R4hhwoUGTvCoa-Yl0,55
+claude_ssh_mcp-1.0.0.dist-info/top_level.txt,sha256=vZvGJ6s7bHvnW8vbR0gXnZwX_iZnHfKCsZUt08IN4P0,15
+claude_ssh_mcp-1.0.0.dist-info/RECORD,,

claude_ssh_mcp-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

claude_ssh_mcp-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+claude-ssh-mcp = claude_ssh_mcp:main

claude_ssh_mcp-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MaraBank
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

claude_ssh_mcp-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+claude_ssh_mcp