tunnel-manager 0.0.5__py3-none-any.whl → 1.0.1__py3-none-any.whl

tunnel_manager-1.0.1.dist-info/METADATA

@@ -0,0 +1,440 @@
+Metadata-Version: 2.4
+Name: tunnel-manager
+Version: 1.0.1
+Summary: Create SSH Tunnels to your remote hosts and host as an MCP Server for Agentic AI!
+Author-email: Audel Rouhi <knucklessg1@gmail.com>
+License: MIT
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: Public Domain
+Classifier: Environment :: Console
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=2.11.3
+Requires-Dist: paramiko>=4.0.0
+Dynamic: license-file
+
+# Tunnel Manager
+
+![PyPI - Version](https://img.shields.io/pypi/v/tunnel-manager)
+![PyPI - Downloads](https://img.shields.io/pypi/dd/tunnel-manager)
+![GitHub Repo stars](https://img.shields.io/github/stars/Knuckles-Team/tunnel-manager)
+![GitHub forks](https://img.shields.io/github/forks/Knuckles-Team/tunnel-manager)
+![GitHub contributors](https://img.shields.io/github/contributors/Knuckles-Team/tunnel-manager)
+![PyPI - License](https://img.shields.io/pypi/l/tunnel-manager)
+![GitHub](https://img.shields.io/github/license/Knuckles-Team/tunnel-manager)
+
+![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/Knuckles-Team/tunnel-manager)
+![GitHub pull requests](https://img.shields.io/github/issues-pr/Knuckles-Team/tunnel-manager)
+![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/Knuckles-Team/tunnel-manager)
+![GitHub issues](https://img.shields.io/github/issues/Knuckles-Team/tunnel-manager)
+
+![GitHub top language](https://img.shields.io/github/languages/top/Knuckles-Team/tunnel-manager)
+![GitHub language count](https://img.shields.io/github/languages/count/Knuckles-Team/tunnel-manager)
+![GitHub repo size](https://img.shields.io/github/repo-size/Knuckles-Team/tunnel-manager)
+![GitHub repo file count (file type)](https://img.shields.io/github/directory-file-count/Knuckles-Team/tunnel-manager)
+![PyPI - Wheel](https://img.shields.io/pypi/wheel/tunnel-manager)
+![PyPI - Implementation](https://img.shields.io/pypi/implementation/tunnel-manager)
+
+*Version: 1.0.1*
+
+This project provides a Python-based `Tunnel` class for secure SSH connections and file transfers, integrated with a FastMCP server (`tunnel_manager_mcp.py`) to expose these capabilities as tools for AI-driven workflows. The implementation supports both standard SSH (e.g., for local networks) and Teleport's secure access platform, leveraging the `paramiko` library for SSH operations.
+
+## Features
+
+### Tunnel Class
+- **Purpose**: Facilitates secure SSH connections, file transfers, and key management for single or multiple hosts.
+- **Key Functionality**:
+    - **Run Remote Commands**: Execute shell commands on a remote host and retrieve output.
+    - **File Upload/Download**: Transfer files to/from a single host or all hosts in an inventory group using SFTP.
+    - **Passwordless SSH Setup**: Configure key-based authentication for secure, passwordless access, with support for RSA and Ed25519 key types.
+    - **SSH Config Management**: Copy local SSH config files to remote hosts.
+    - **Key Rotation**: Generate and deploy new SSH key pairs (RSA or Ed25519), updating `authorized_keys`.
+    - **Inventory Support**: Operate on multiple hosts defined in an Ansible-style YAML inventory, with group targeting (e.g., `all`, `homelab`, `poweredge`).
+    - **Teleport Support**: Seamlessly integrates with Teleport's certificate-based authentication and proxying.
+    - **Configuration Flexibility**: Loads SSH settings from `~/.ssh/config` by default, with optional overrides for username, password, identity files, certificates, and proxy commands.
+    - **Logging**: Optional file-based logging for debugging and auditing.
+    - **Parallel Execution**: Support for parallel operations across multiple hosts with configurable thread limits.
+    - **Key Type Support**: Explicit support for both RSA and Ed25519 keys in authentication, generation, and rotation for enhanced security and compatibility.
+
+## FastMCP Server
+- **Purpose**: Exposes `Tunnel` class functionality as a FastMCP server, enabling AI tools to perform remote operations programmatically.
+- **Tools Provided**:
+    - `run_command_on_remote_host`: Runs a shell command on a single remote host.
+    - `send_file_to_remote_host`: Uploads a file to a single remote host via SFTP.
+    - `receive_file_from_remote_host`: Downloads a file from a single remote host via SFTP.
+    - `check_ssh_server`: Checks if the SSH server is running and configured for key-based authentication.
+    - `test_key_auth`: Tests key-based authentication for a host.
+    - `setup_passwordless_ssh`: Sets up passwordless SSH for a single host.
+    - `copy_ssh_config`: Copies an SSH config file to a single remote host.
+    - `rotate_ssh_key`: Rotates SSH keys for a single host.
+    - `remove_host_key`: Removes a host’s key from the local `known_hosts` file.
+    - `configure_key_auth_on_inventory`: Sets up passwordless SSH for all hosts in an inventory group.
+    - `run_command_on_inventory`: Runs a command on all hosts in an inventory group.
+    - `copy_ssh_config_on_inventory`: Copies an SSH config file to all hosts in an inventory group.
+    - `rotate_ssh_key_on_inventory`: Rotates SSH keys for all hosts in an inventory group.
+    - `send_file_to_inventory`: Uploads a file to all hosts in an inventory group via SFTP.
+    - `receive_file_from_inventory`: Downloads a file from all hosts in an inventory group via SFTP.
+- **Transport Options**: Supports `stdio` (for local scripting) and `http` (for networked access) transport modes.
+- **Progress Reporting**: Integrates with FastMCP's `Context` for progress updates during operations.
+- **Logging**: Comprehensive logging to a file (`tunnel_mcp.log` by default) or a user-specified file.
+
+<details>
+  <summary><b>Usage:</b></summary>
+
+## Tunnel Class
+The `Tunnel` class can be used standalone for SSH operations. Examples:
+
+### Using RSA Keys
+```python
+from tunnel_manager.tunnel_manager import Tunnel
+
+# Initialize with a remote host (assumes ~/.ssh/config or explicit params)
+tunnel = Tunnel(
+    remote_host="192.168.1.10",
+    username="admin",
+    password="mypassword",
+    identity_file="/path/to/id_rsa",
+    certificate_file="/path/to/cert",  # Optional for Teleport
+    proxy_command="tsh proxy ssh %h",  # Optional for Teleport
+    ssh_config_file="~/.ssh/config",
+)
+
+# Connect and run a command
+tunnel.connect()
+out, err = tunnel.run_command("ls -la /tmp")
+print(f"Output: {out}\nError: {err}")
+
+# Upload a file
+tunnel.send_file("/local/file.txt", "/remote/file.txt")
+
+# Download a file
+tunnel.receive_file("/remote/file.txt", "/local/downloaded.txt")
+
+# Setup passwordless SSH with RSA
+tunnel.setup_passwordless_ssh(local_key_path="~/.ssh/id_rsa", key_type="rsa")
+
+# Copy SSH config
+tunnel.copy_ssh_config("/local/ssh_config", "~/.ssh/config")
+
+# Rotate SSH key with RSA
+tunnel.rotate_ssh_key("/path/to/new_rsa_key", key_type="rsa")
+
+# Close the connection
+tunnel.close()
+```
+
+### Using Ed25519 Keys
+```python
+from tunnel_manager.tunnel_manager import Tunnel
+
+# Initialize with a remote host (assumes ~/.ssh/config or explicit params)
+tunnel = Tunnel(
+    remote_host="192.168.1.10",
+    username="admin",
+    password="mypassword",
+    identity_file="/path/to/id_ed25519",
+    certificate_file="/path/to/cert",  # Optional for Teleport
+    proxy_command="tsh proxy ssh %h",  # Optional for Teleport
+    ssh_config_file="~/.ssh/config",
+)
+
+# Connect and run a command
+tunnel.connect()
+out, err = tunnel.run_command("ls -la /tmp")
+print(f"Output: {out}\nError: {err}")
+
+# Upload a file
+tunnel.send_file("/local/file.txt", "/remote/file.txt")
+
+# Download a file
+tunnel.receive_file("/remote/file.txt", "/local/downloaded.txt")
+
+# Setup passwordless SSH with Ed25519
+tunnel.setup_passwordless_ssh(local_key_path="~/.ssh/id_ed25519", key_type="ed25519")
+
+# Copy SSH config
+tunnel.copy_ssh_config("/local/ssh_config", "~/.ssh/config")
+
+# Rotate SSH key with Ed25519
+tunnel.rotate_ssh_key("/path/to/new_ed25519_key", key_type="ed25519")
+
+# Close the connection
+tunnel.close()
+```
+
+## Tunnel Manager CLI Usage
+The `tunnel_manager.py` script provides a CLI for managing SSH operations across hosts defined in an Ansible-style YAML inventory file. Below are examples for each command, targeting different inventory groups (`all`, `homelab`, `poweredge`). The CLI now supports both RSA and Ed25519 keys via the `--key-type` flag for relevant commands (default: `ed25519`).
+
+**Inventory File Example (`inventory.yml`)**:
+```yaml
+all:
+  hosts:
+    r510:
+      ansible_host: 192.168.1.10
+      ansible_user: admin
+      ansible_ssh_private_key_file: "~/.ssh/id_ed25519"
+    r710:
+      ansible_host: 192.168.1.11
+      ansible_user: admin
+      ansible_ssh_pass: mypassword
+    gr1080:
+      ansible_host: 192.168.1.14
+      ansible_user: admin
+      ansible_ssh_private_key_file: "~/.ssh/id_rsa"
+homelab:
+  hosts:
+    r510:
+      ansible_host: 192.168.1.10
+      ansible_user: admin
+      ansible_ssh_private_key_file: "~/.ssh/id_ed25519"
+    r710:
+      ansible_host: 192.168.1.11
+      ansible_user: admin
+      ansible_ssh_pass: mypassword
+    gr1080:
+      ansible_host: 192.168.1.14
+      ansible_user: admin
+      ansible_ssh_private_key_file: "~/.ssh/id_rsa"
+poweredge:
+  hosts:
+    r510:
+      ansible_host: 192.168.1.10
+      ansible_user: admin
+      ansible_ssh_private_key_file: "~/.ssh/id_ed25519"
+    r710:
+      ansible_host: 192.168.1.11
+      ansible_user: admin
+      ansible_ssh_pass: mypassword
+```
+
+Replace IPs, usernames, and passwords with your actual values.
+
+### CLI Commands
+
+#### 1. Setup Passwordless SSH
+Set up passwordless SSH for hosts in the inventory, distributing a shared key. Use `--key-type` to specify RSA or Ed25519 (default: ed25519).
+- **Target `all` group (sequential, Ed25519)**:
+  ```bash
+  tunnel-manager setup-all --inventory inventory.yml --shared-key-path ~/.ssh/id_shared --key-type ed25519
+  ```
+- **Target `homelab` group (parallel, 3 threads, RSA)**:
+  ```bash
+  tunnel-manager setup-all --inventory inventory.yml --shared-key-path ~/.ssh/id_shared_rsa --key-type rsa --group homelab --parallel --max-threads 3
+  ```
+- **Target `poweredge` group (sequential, Ed25519)**:
+  ```bash
+  tunnel-manager --log-file setup_poweredge.log setup-all --inventory inventory.yml --shared-key-path ~/.ssh/id_shared --key-type ed25519 --group poweredge
+  ```
+
+#### 2. Run a Command
+Execute a shell command on all hosts in the specified group.
+- **Run `uptime` on `all` group (sequential)**:
+  ```bash
+  tunnel-manager run-command --inventory inventory.yml --remote-command "uptime"
+  ```
+- **Run `df -h` on `homelab` group (parallel, 5 threads)**:
+  ```bash
+  tunnel-manager run-command --inventory inventory.yml --remote-command "df -h" --group homelab --parallel --max-threads 5
+  ```
+- **Run `whoami` on `poweredge` group (sequential)**:
+  ```bash
+  tunnel-manager run-command --inventory inventory.yml --remote-command "whoami" --group poweredge
+  ```
+
+#### 3. Copy SSH Config
+Copy a local SSH config file to the remote hosts’ `~/.ssh/config`.
+- **Copy to `all` group (sequential)**:
+  ```bash
+  tunnel-manager copy-config --inventory inventory.yml --local-config-path ~/.ssh/config
+  ```
+- **Copy to `homelab` group (parallel, 4 threads)**:
+  ```bash
+  tunnel-manager copy-config --inventory inventory.yml --local-config-path ~/.ssh/config --group homelab --parallel --max-threads 4
+  ```
+- **Copy to `poweredge` group with custom remote path**:
+  ```bash
+  tunnel-manager --log-file copy_config.log copy-config --inventory inventory.yml --local-config-path ~/.ssh/config --remote-config-path ~/.ssh/custom_config --group poweredge
+  ```
+
+#### 4. Rotate SSH Keys
+Rotate SSH keys for hosts, generating new keys with a prefix. Use `--key-type` to specify RSA or Ed25519 (default: ed25519).
+- **Rotate keys for `all` group (sequential, Ed25519)**:
+  ```bash
+  tunnel-manager rotate-key --inventory inventory.yml --key-prefix ~/.ssh/id_ --key-type ed25519
+  ```
+- **Rotate keys for `homelab` group (parallel, 3 threads, RSA)**:
+  ```bash
+  tunnel-manager rotate-key --inventory inventory.yml --key-prefix ~/.ssh/id_rsa_ --key-type rsa --group homelab --parallel --max-threads 3
+  ```
+- **Rotate keys for `poweredge` group (sequential, Ed25519)**:
+  ```bash
+  tunnel-manager --log-file rotate.log rotate-key --inventory inventory.yml --key-prefix ~/.ssh/id_ --key-type ed25519 --group poweredge
+  ```
+
+#### 5. Upload a File
+Upload a local file to all hosts in the specified group.
+- **Upload to `all` group (sequential)**:
+  ```bash
+  tunnel-manager send-file --inventory inventory.yml --local-path ./myfile.txt --remote-path /home/user/myfile.txt
+  ```
+- **Upload to `homelab` group (parallel, 3 threads)**:
+  ```bash
+  tunnel-manager send-file --inventory inventory.yml --local-path ./myfile.txt --remote-path /home/user/myfile.txt --group homelab --parallel --max-threads 3
+  ```
+- **Upload to `poweredge` group (sequential)**:
+  ```bash
+  tunnel-manager --log-file upload_poweredge.log send-file --inventory inventory.yml --local-path ./myfile.txt --remote-path /home/user/myfile.txt --group poweredge
+  ```
+
+#### 6. Download a File
+Download a file from all hosts in the specified group, saving to host-specific subdirectories (e.g., `downloads/R510/myfile.txt`).
+- **Download from `all` group (sequential)**:
+  ```bash
+  tunnel-manager receive-file --inventory inventory.yml --remote-path /home/user/myfile.txt --local-path-prefix ./downloads
+  ```
+- **Download from `homelab` group (parallel, 3 threads)**:
+  ```bash
+  tunnel-manager receive-file --inventory inventory.yml --remote-path /home/user/myfile.txt --local-path-prefix ./downloads --group homelab --parallel --max-threads 3
+  ```
+- **Download from `poweredge` group (sequential)**:
+  ```bash
+  tunnel-manager --log-file download_poweredge.log receive-file --inventory inventory.yml --remote-path /home/user/myfile.txt --local-path-prefix ./downloads --group poweredge
+  ```
+
+### CLI Command Table
+| Short Flag | Long Flag            | Description                                              | Required | Default Value |
+|------------|----------------------|----------------------------------------------------------|----------|---------------|
+| -h         | --help               | Show usage for the script                                | No       | None          |
+|            | --log-file           | Log to specified file (default: console output)           | No       | Console       |
+|            | setup-all            | Setup passwordless SSH for all hosts in inventory         | Yes*     | None          |
+|            | --inventory          | YAML inventory path                                      | Yes      | None          |
+|            | --shared-key-path    | Path to shared private key                               | No       | ~/.ssh/id_shared |
+|            | --key-type           | Key type (rsa or ed25519)                                | No       | ed25519       |
+|            | --group              | Inventory group to target                                 | No       | all           |
+|            | --parallel           | Run operation in parallel                                | No       | False         |
+|            | --max-threads        | Max threads for parallel execution                       | No       | 5             |
+|            | run-command          | Run a shell command on all hosts in inventory            | Yes*     | None          |
+|            | --remote-command     | Shell command to run                                     | Yes      | None          |
+|            | copy-config          | Copy SSH config to all hosts in inventory                | Yes*     | None          |
+|            | --local-config-path  | Local SSH config path                                    | Yes      | None          |
+|            | --remote-config-path | Remote path for SSH config                               | No       | ~/.ssh/config |
+|            | rotate-key           | Rotate SSH keys for all hosts in inventory               | Yes*     | None          |
+|            | --key-prefix         | Prefix for new key paths (appends hostname)              | No       | ~/.ssh/id_    |
+|            | --key-type           | Key type (rsa or ed25519)                                | No       | ed25519       |
+|            | send-file            | Upload a file to all hosts in inventory                  | Yes*     | None          |
+|            | --local-path         | Local file path to upload                                | Yes      | None          |
+|            | --remote-path        | Remote destination path                                  | Yes      | None          |
+|            | receive-file         | Download a file from all hosts in inventory              | Yes*     | None          |
+|            | --remote-path        | Remote file path to download                             | Yes      | None          |
+|            | --local-path-prefix  | Local directory path prefix to save files                | Yes      | None          |
+
+### Notes
+One of the commands (`setup-all`, `run-command`, `copy-config`, `rotate-key`, `send-file`, `receive-file`) must be specified as the first argument to `tunnel_manager.py`. Each command has required arguments that must be specified with flags:
+- `setup-all`: Requires `--inventory`.
+- `run-command`: Requires `--inventory` and `--remote-command`.
+- `copy-config`: Requires `--inventory` and `--local-config-path`.
+- `rotate-key`: Requires `--inventory`.
+- `send-file`: Requires `--inventory`, `--local-path`, and `--remote-path`.
+- `receive-file`: Requires `--inventory`, `--remote-path`, and `--local-path-prefix`.
+
+### Additional Notes
+- Ensure `ansible_host` values in `inventory.yml` are resolvable IPs or hostnames.
+- Update `ansible_ssh_private_key_file` in the inventory after running `rotate-key`.
+- Use `--log-file` for file-based logging or omit for console output.
+- The `--parallel` option speeds up operations but may overload resources; adjust `--max-threads` as needed.
+- The `receive-file` command saves files to `local_path_prefix/<hostname>/<filename>` to preserve original filenames and avoid conflicts.
+- Ed25519 keys are recommended for better security and performance over RSA, but RSA is supported for compatibility with older systems.
+
+## FastMCP Server
+The FastMCP server exposes the `Tunnel` functionality as AI-accessible tools. Start the server with:
+
+```bash
+python tunnel_manager_mcp.py --transport stdio
+```
+
+Or for HTTP transport:
+```bash
+python tunnel_manager_mcp.py --transport http --host 127.0.0.1 --port 8080
+```
+
+</details>
+
+<details>
+  <summary><b>Installation Instructions:</b></summary>
+
+## Use with AI
+
+Configure `mcp.json`
+```json
+{
+  "mcpServers": {
+    "tunnel_manager": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--with",
+        "tunnel-manager",
+        "tunnel_manager_mcp"
+      ],
+      "env": {
+        "TUNNEL_REMOTE_HOST": "192.168.1.12",      // Optional
+        "TUNNEL_USERNAME": "admin",                // Optional
+        "TUNNEL_PASSWORD": "",                     // Optional
+        "TUNNEL_REMOTE_PORT": "22",                // Optional
+        "TUNNEL_IDENTITY_FILE": "",                // Optional
+        "TUNNEL_INVENTORY": "~/inventory.yaml",    // Optional
+        "TUNNEL_INVENTORY_GROUP": "all",           // Optional
+        "TUNNEL_PARALLEL": "true",                 // Optional
+        "TUNNEL_CERTIFICATE": "",                  // Optional
+        "TUNNEL_PROXY_COMMAND": "",                // Optional
+        "TUNNEL_LOG_FILE": "~/tunnel_log.txt",     // Optional
+        "TUNNEL_MAX_THREADS": "6"                  // Optional
+      },
+      "timeout": 200000
+    }
+  }
+}
+```
+
+### Deploy MCP Server as a Container
+```bash
+docker pull knucklessg1/tunnel-manager:latest
+```
+
+Modify the `compose.yml`
+```yaml
+services:
+  tunnel-manager:
+    image: knucklessg1/tunnel-manager:latest
+    environment:
+      - HOST=0.0.0.0
+      - PORT=8021
+    ports:
+      - 8021:8021
+```
+
+### Install Python Package
+```bash
+python -m pip install tunnel-manager
+```
+
+or
+
+```bash
+uv pip install --upgrade tunnel-manager
+```
+
+</details>
+
+<details>
+  <summary><b>Repository Owners:</b></summary>
+
+
+<img width="100%" height="180em" src="https://github-readme-stats.vercel.app/api?username=Knucklessg1&show_icons=true&hide_border=true&&count_private=true&include_all_commits=true" />
+
+![GitHub followers](https://img.shields.io/github/followers/Knucklessg1)
+![GitHub User's stars](https://img.shields.io/github/stars/Knucklessg1)
+</details>

tunnel_manager-1.0.1.dist-info/RECORD

@@ -0,0 +1,11 @@
+tests/test_tunnel.py,sha256=Dj6z1EM50uGqEJA0GBDP6L8ZPUMRAJNT7dAnwkuSgNU,2461
+tunnel_manager/__init__.py,sha256=cqAitAkoCcEkaCQcP7Y8tngiUK7pU6SIMlmpABShh9g,807
+tunnel_manager/__main__.py,sha256=Z1uxNLjwIjJpvu97bXrvsawnghJScA52E2wtAgg5MLo,152
+tunnel_manager/tunnel_manager.py,sha256=DZn2Zs0OPxB_2wWqkro--UbFLdoe8kivaeLvKZKWANM,39384
+tunnel_manager/tunnel_manager_mcp.py,sha256=_TVDIH7fZpNsADbCKpMU8uzTUU41l9YqKNuK6dvaxl4,76157
+tunnel_manager-1.0.1.dist-info/licenses/LICENSE,sha256=Z1xmcrPHBnGCETO_LLQJUeaSNBSnuptcDVTt4kaPUOE,1060
+tunnel_manager-1.0.1.dist-info/METADATA,sha256=ky7DsUsho_CrI18mKDvvY74aE-L29tcJiI1jwkdg89w,20683
+tunnel_manager-1.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+tunnel_manager-1.0.1.dist-info/entry_points.txt,sha256=hYtm4jvOAew8CbeqqUBH2nXY51mSQwhF4GhU0yclV6c,154
+tunnel_manager-1.0.1.dist-info/top_level.txt,sha256=W4J-lyPPNeOS696f0LneZsP2MVERR8HE9UHbAFQ550A,21
+tunnel_manager-1.0.1.dist-info/RECORD,,

{tunnel_manager-0.0.5.dist-info → tunnel_manager-1.0.1.dist-info}/entry_points.txt

@@ -1,2 +1,3 @@
 [console_scripts]
+tunnel-manager = tunnel_manager.tunnel_manager:tunnel_manager
 tunnel-manager-mcp = tunnel_manager.tunnel_manager_mcp:tunnel_manager_mcp

{tunnel_manager-0.0.5.dist-info → tunnel_manager-1.0.1.dist-info}/top_level.txt

@@ -1 +1,2 @@
+tests
 tunnel_manager

tunnel_manager-0.0.5.dist-info/METADATA

@@ -1,190 +0,0 @@
-Metadata-Version: 2.4
-Name: tunnel-manager
-Version: 0.0.5
-Summary: Create SSH Tunnels to your remote hosts and host as an MCP Server for Agentic AI!
-Author-email: Audel Rouhi <knucklessg1@gmail.com>
-License: MIT
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: Public Domain
-Classifier: Environment :: Console
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: fastmcp>=2.11.3
-Requires-Dist: paramiko>=4.0.0
-Dynamic: license-file
-
-# Tunnel Manager
-
-![PyPI - Version](https://img.shields.io/pypi/v/tunnel-manager)
-![PyPI - Downloads](https://img.shields.io/pypi/dd/tunnel-manager)
-![GitHub Repo stars](https://img.shields.io/github/stars/Knuckles-Team/tunnel-manager)
-![GitHub forks](https://img.shields.io/github/forks/Knuckles-Team/tunnel-manager)
-![GitHub contributors](https://img.shields.io/github/contributors/Knuckles-Team/tunnel-manager)
-![PyPI - License](https://img.shields.io/pypi/l/tunnel-manager)
-![GitHub](https://img.shields.io/github/license/Knuckles-Team/tunnel-manager)
-
-![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/Knuckles-Team/tunnel-manager)
-![GitHub pull requests](https://img.shields.io/github/issues-pr/Knuckles-Team/tunnel-manager)
-![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/Knuckles-Team/tunnel-manager)
-![GitHub issues](https://img.shields.io/github/issues/Knuckles-Team/tunnel-manager)
-
-![GitHub top language](https://img.shields.io/github/languages/top/Knuckles-Team/tunnel-manager)
-![GitHub language count](https://img.shields.io/github/languages/count/Knuckles-Team/tunnel-manager)
-![GitHub repo size](https://img.shields.io/github/repo-size/Knuckles-Team/tunnel-manager)
-![GitHub repo file count (file type)](https://img.shields.io/github/directory-file-count/Knuckles-Team/tunnel-manager)
-![PyPI - Wheel](https://img.shields.io/pypi/wheel/tunnel-manager)
-![PyPI - Implementation](https://img.shields.io/pypi/implementation/tunnel-manager)
-
-*Version: 0.0.5*
-
-This project provides a Python-based `Tunnel` class for secure SSH connections and file transfers,
-integrated with a FastMCP server (`tunnel_mcp.py`) to expose these capabilities as tools for AI-driven workflows.
-The implementation supports both standard SSH (e.g., for local networks) and
-Teleport's secure access platform, leveraging the `paramiko` library for SSH operations.
-
-## Features
-
-### Tunnel Class
-- **Purpose**: Facilitates secure SSH connections and file transfers to remote hosts.
-- **Key Functionality**:
-    - **Run Remote Commands**: Execute shell commands on a remote host and retrieve output.
-    - **File Upload/Download**: Transfer files to/from a remote host using SFTP.
-    - **Teleport Support**: Seamlessly integrates with Teleport's certificate-based authentication and proxying.
-    - **Configuration Flexibility**: Loads SSH settings from `~/.ssh/config` by default, with optional overrides for identity files, certificates, and proxy commands.
-    - **Logging**: Optional file-based logging for debugging and auditing.
-
-### FastMCP Server
-- **Purpose**: Exposes `Tunnel` class functionality as a FastMCP server, enabling AI tools to perform remote operations programmatically.
-- **Tools Provided**:
-    - `run_remote_command`: Runs a shell command on a remote host and returns output.
-    - `upload_file`: Uploads a file to a remote host via SFTP.
-    - `download_file`: Downloads a file from a remote host via SFTP.
-- **Transport Options**: Supports `stdio` (for local scripting) and `http` (for networked access) transport modes.
-- **Progress Reporting**: Integrates with FastMCP's `Context` for progress updates during operations.
-- **Logging**: Comprehensive logging to a file (`tunnel_mcp.log` by default).
-
-
-<details>
-  <summary><b>Usage:</b></summary>
-
-## Tunnel Class
-The `Tunnel` class can be used standalone for SSH operations. Example:
-
-```python
-from tunnel_manager import Tunnel
-
-# Initialize with a remote host (assumes ~/.ssh/config or explicit params)
-tunnel = Tunnel(
-    remote_host="example.com",
-    identity_file="/path/to/id_rsa",
-    certificate_file="/path/to/cert",  # Optional for Teleport
-    proxy_command="tsh proxy ssh %h",  # Optional for Teleport
-    log_file="tunnel.log"
-)
-
-# Connect and run a command
-tunnel.connect()
-out, err = tunnel.run_command("ls -la /tmp")
-print(f"Output: {out}\nError: {err}")
-
-# Upload a file
-tunnel.send_file("/local/file.txt", "/remote/file.txt")
-
-# Download a file
-tunnel.receive_file("/remote/file.txt", "/local/downloaded.txt")
-
-# Close the connection
-tunnel.close()
-```
-
-
-## FastMCP Server
-The FastMCP server exposes the `Tunnel` functionality as AI-accessible tools. Start the server with:
-
-```bash
-python tunnel_mcp.py --transport stdio
-```
-
-Or for HTTP transport:
-```bash
-python tunnel_mcp.py --transport http --host 127.0.0.1 --port 8080
-```
-
-</details>
-
-<details>
-  <summary><b>Installation Instructions:</b></summary>
-
-## Use with AI
-
-Configure `mcp.json`
-```json
-{
-  "mcpServers": {
-    "tunnel_manager": {
-      "command": "uv",
-      "args": [
-        "run",
-        "--with",
-        "tunnel-manager",
-        "tunnel-manager-mcp"
-      ],
-      "env": {
-        "TUNNEL_REMOTE_HOST": "user@192.168.1.12", // Optional
-        "TUNNEL_REMOTE_PORT": "22",                // Optional
-        "TUNNEL_IDENTITY_FILE": "",                // Optional
-        "TUNNEL_CERTIFICATE": "",                  // Optional
-        "TUNNEL_PROXY_COMMAND": "",                // Optional
-        "TUNNEL_LOG_FILE": "~./tunnel_log.txt"     // Optional
-      },
-      "timeout": 200000
-    }
-  }
-}
-```
-
-### Deploy MCP Server as a container
-```bash
-docker pull knucklessg1/tunnel-manager:latest
-```
-
-Modify the `compose.yml`
-
-```compose
-services:
-  tunnel-manager:
-    image: knucklessg1/tunnel-manager:latest
-    environment:
-      - HOST=0.0.0.0
-      - PORT=8021
-    ports:
-      - 8021:8021
-```
-
-### Install Python Package
-
-```bash
-python -m pip install tunnel-manager
-```
-
-or
-
-```bash
-uv pip install --upgrade tunnel-manager
-```
-
-
-</details>
-
-<details>
-  <summary><b>Repository Owners:</b></summary>
-
-
-<img width="100%" height="180em" src="https://github-readme-stats.vercel.app/api?username=Knucklessg1&show_icons=true&hide_border=true&&count_private=true&include_all_commits=true" />
-
-![GitHub followers](https://img.shields.io/github/followers/Knucklessg1)
-![GitHub User's stars](https://img.shields.io/github/stars/Knucklessg1)
-</details>

tunnel_manager-0.0.5.dist-info/RECORD

@@ -1,10 +0,0 @@
-tunnel_manager/__init__.py,sha256=9I_qajRiMP4bxiKdEIx0bKIeTg8b4x1TsYnTMfbWIJA,273
-tunnel_manager/__main__.py,sha256=Z1uxNLjwIjJpvu97bXrvsawnghJScA52E2wtAgg5MLo,152
-tunnel_manager/tunnel_manager.py,sha256=_MokYwLLe0ekQA1CeAaH_4JTRx0TctGUJLwai3MIQvc,6565
-tunnel_manager/tunnel_manager_mcp.py,sha256=ZYhmenIaApFBHMKDh05zxk6NffYw0yI67flt30VFDfQ,10568
-tunnel_manager-0.0.5.dist-info/licenses/LICENSE,sha256=Z1xmcrPHBnGCETO_LLQJUeaSNBSnuptcDVTt4kaPUOE,1060
-tunnel_manager-0.0.5.dist-info/METADATA,sha256=yeWbqoTI2PzWJOHz0Mi9FNq2h-dOki2q2zUDsn8J2pY,6568
-tunnel_manager-0.0.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-tunnel_manager-0.0.5.dist-info/entry_points.txt,sha256=mxjinmmRNDVn_VbKHi63vkSvj7pp8btUKFQeXLm4-WY,92
-tunnel_manager-0.0.5.dist-info/top_level.txt,sha256=AlbS1pBPQr8wIlDsmwNxGDLK4L4s4CY_X9AellT3-x8,15
-tunnel_manager-0.0.5.dist-info/RECORD,,