remote-admin-mcp 0.1.0__tar.gz

remote_admin_mcp-0.1.0/.env.example

@@ -0,0 +1,21 @@
+# SSH Server Configuration Examples
+
+# Server 1
+SSH_SERVER_1_NAME=production
+SSH_SERVER_1_HOST=prod.example.com
+SSH_SERVER_1_PORT=22
+SSH_SERVER_1_USER=admin
+SSH_SERVER_1_PASSWORD=your-password-here
+
+# Server 2
+SSH_SERVER_2_NAME=staging
+SSH_SERVER_2_HOST=staging.example.com
+SSH_SERVER_2_PORT=22
+SSH_SERVER_2_USER=deploy
+SSH_SERVER_2_PASSWORD=your-password-here
+
+# Add more servers by incrementing the number
+# SSH_SERVER_3_NAME=...
+
+# Audit Log (optional, default: ~/.ssh-mcp-audit.log)
+# SSH_MCP_AUDIT_LOG=/var/log/ssh-mcp-audit.log

remote_admin_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Build
+        run: |
+          pip install build
+          python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

remote_admin_mcp-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+.env
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+.kiro/
+.vibe/

remote_admin_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Frank Schaellert
+
+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.

remote_admin_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,268 @@
+Metadata-Version: 2.4
+Name: remote-admin-mcp
+Version: 0.1.0
+Summary: MCP Server for remote server administration via SSH — execute commands, manage files, edit configs, transfer files, control services. No agents needed on target servers.
+Project-URL: Homepage, https://github.com/intershopper/remote-admin-mcp
+Project-URL: Repository, https://github.com/intershopper/remote-admin-mcp
+Author-email: Frank Schaellert <intershopper@gmx.de>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.26.0
+Requires-Dist: paramiko>=3.4.0
+Requires-Dist: pyjwt[crypto]>=2.12.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: starlette>=0.38.0
+Requires-Dist: uvicorn>=0.30.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# SSH MCP Server
+
+MCP Server für SSH-basierte Server-Administration. Ermöglicht KI-Assistenten die Verwaltung von Remote-Servern via SSH.
+
+## Supported MCP Clients
+
+```mermaid
+graph LR
+    subgraph Getestet
+        K[Kiro CLI]
+        C[Claude Desktop]
+    end
+    subgraph Kompatibel
+        A[Alle MCP-fähigen Clients<br/>stdio + StreamableHTTP]
+    end
+    K --> MCP[SSH MCP Server]
+    C --> MCP
+    A --> MCP
+```
+
+| Client | Transport | Status |
+|--------|-----------|--------|
+| [Kiro CLI](https://github.com/aws/kiro) | stdio | ✅ getestet |
+| [Claude Desktop](https://claude.ai/download) | stdio | ✅ getestet |
+| Jeder MCP-Client | stdio / StreamableHTTP | ✅ kompatibel |
+
+## Features
+
+Verwalte Linux-Server per SSH — direkt aus dem KI-Assistenten heraus. Keine Agents, Daemons oder Tools auf den Zielservern nötig. Nur ein SSH-Zugang reicht.
+
+```mermaid
+graph LR
+    AI[KI-Assistent] -->|MCP| S[SSH MCP Server]
+    S -->|SSH/SFTP| R1[Server 1]
+    S -->|SSH/SFTP| R2[Server 2]
+    S -->|SSH/SFTP| RN[Server N]
+```
+
+- **Agentless**: Kein Setup auf den Zielservern — funktioniert mit jedem SSH-Zugang
+- **Remote Command Execution**: Einzelbefehle oder mehrzeilige Scripts ausführen
+- **Sudo Support**: Befehle mit `sudo` ausführen, ohne interaktives Passwort
+- **File Operations**: Dateien lesen (teilweise/komplett), schreiben, suchen, chirurgisch editieren
+- **File Transfer**: Upload/Download via SFTP
+- **Service Management**: Systemd Services starten, stoppen, restarten, Status prüfen
+- **Code Navigation**: Funktions-/Klassen-Übersicht aus Quelldateien extrahieren (grep-basiert, kein Language Server nötig)
+- **Multi-Server**: Beliebig viele Server parallel verwalten
+- **Connection Pooling**: SSH-Verbindungen werden 5 Minuten wiederverwendet
+- **User Approval**: Schreibende Operationen erfordern Bestätigung durch den Operator
+- **Audit Log**: Alle Aktionen werden protokolliert (Pfad konfigurierbar)
+
+## Installation
+
+### Von PyPI
+
+```bash
+pip install remote-admin-mcp
+```
+
+### Mit uv (empfohlen für Entwicklung)
+
+```bash
+# Virtuelle Umgebung erstellen und Abhängigkeiten installieren
+uv venv
+source .venv/bin/activate  # Windows: .venv\Scripts\activate
+uv pip install -e ".[dev]"
+```
+
+### Mit pip
+
+```bash
+# Virtuelle Umgebung erstellen
+python -m venv .venv
+source .venv/bin/activate  # Windows: .venv\Scripts\activate
+
+# Abhängigkeiten installieren
+pip install -e ".[dev]"
+```
+
+## Konfiguration
+
+1. Kopiere `.env.example` zu `.env`:
+```bash
+cp .env.example .env
+```
+
+2. Bearbeite `.env` mit deinen Server-Zugangsdaten:
+```bash
+SSH_SERVER_1_NAME=production
+SSH_SERVER_1_HOST=prod.example.com
+SSH_SERVER_1_PORT=22
+SSH_SERVER_1_USER=admin
+SSH_SERVER_1_PASSWORD=your-password
+
+SSH_SERVER_2_NAME=staging
+SSH_SERVER_2_HOST=staging.example.com
+SSH_SERVER_2_PORT=22
+SSH_SERVER_2_USER=deploy
+SSH_SERVER_2_PASSWORD=your-password
+```
+
+## MCP Tools
+
+### list_servers
+Liste alle konfigurierten Server auf.
+
+### execute_command
+Führe einen Befehl auf einem Remote-Server aus.
+
+**Parameter:**
+- `server` (string): Server-Name
+- `command` (string): Auszuführender Befehl
+- `use_sudo` (boolean): Mit sudo ausführen
+
+### read_file
+Lese eine Datei vom Remote-Server.
+
+**Parameter:**
+- `server` (string): Server-Name
+- `path` (string): Dateipfad
+
+### write_file
+Schreibe eine Datei auf den Remote-Server.
+
+**Parameter:**
+- `server` (string): Server-Name
+- `path` (string): Dateipfad
+- `content` (string): Dateiinhalt
+
+### get_service_status
+Prüfe den Status eines systemd Services.
+
+**Parameter:**
+- `server` (string): Server-Name
+- `service` (string): Service-Name
+
+### manage_service
+Verwalte einen systemd Service (start/stop/restart/reload).
+
+**Parameter:**
+- `server` (string): Server-Name
+- `service` (string): Service-Name
+- `action` (string): Aktion (start/stop/restart/reload)
+
+## Verwendung mit KI-Assistenten
+
+### Kiro CLI / Claude Desktop (uvx — empfohlen)
+
+Kein manuelles Installieren nötig — `uvx` lädt und cached das Paket automatisch:
+
+```json
+{
+  "mcpServers": {
+    "ssh": {
+      "command": "uvx",
+      "args": ["remote-admin-mcp"],
+      "env": {
+        "SSH_SERVER_1_NAME": "production",
+        "SSH_SERVER_1_HOST": "prod.example.com",
+        "SSH_SERVER_1_USER": "admin",
+        "SSH_SERVER_1_KEY_FILE": "~/.ssh/id_ed25519"
+      }
+    }
+  }
+}
+```
+
+### Alternative: Mit .env-Datei
+
+```json
+{
+  "mcpServers": {
+    "ssh": {
+      "command": "uvx",
+      "args": ["--env-file", "/path/to/.env", "remote-admin-mcp"]
+    }
+  }
+}
+```
+
+### Alternative: Lokale Installation
+
+```json
+{
+  "mcpServers": {
+    "ssh": {
+      "command": "/path/to/.venv/bin/ssh_mcp_server"
+    }
+  }
+}
+```
+
+## Beispiele
+
+**Log-Analyse:**
+```
+"Zeige mir die letzten 100 Zeilen vom nginx error log auf production"
+```
+
+**Service Restart:**
+```
+"Starte den nginx Service auf staging neu"
+```
+
+**Config ändern:**
+```
+"Lies die nginx.conf auf production und erhöhe worker_processes auf 4"
+```
+
+## Sicherheit
+
+- Schreibende Tools erfordern **User-Approval** durch den MCP Client
+- Lese-Tools (`list_servers`, `read_file`, `search_in_file`, `get_file_structure`) sind auto-approved
+- SSH-Key-Authentifizierung empfohlen (Passwort-Auth möglich)
+- `.env` sollte NICHT ins Git committed werden
+
+### Audit Log
+
+Alle Aktionen werden in ein Logfile geschrieben:
+
+```
+[2026-04-12 13:14:00] [production] execute: tail -100 /var/log/syslog
+[2026-04-12 13:14:05] [production] write_file: /etc/nginx/nginx.conf — Config update
+```
+
+Default: `~/.ssh-mcp-audit.log`. Konfigurierbar per Environment-Variable:
+
+```bash
+SSH_MCP_AUDIT_LOG=/var/log/ssh-mcp-audit.log
+```
+
+## Entwicklung
+
+```bash
+# Tests ausführen
+pytest -v
+
+# Linting
+ruff check src/
+```
+
+## Lizenz
+
+MIT — siehe [LICENSE](LICENSE)

remote_admin_mcp-0.1.0/README.md

@@ -0,0 +1,243 @@
+# SSH MCP Server
+
+MCP Server für SSH-basierte Server-Administration. Ermöglicht KI-Assistenten die Verwaltung von Remote-Servern via SSH.
+
+## Supported MCP Clients
+
+```mermaid
+graph LR
+    subgraph Getestet
+        K[Kiro CLI]
+        C[Claude Desktop]
+    end
+    subgraph Kompatibel
+        A[Alle MCP-fähigen Clients<br/>stdio + StreamableHTTP]
+    end
+    K --> MCP[SSH MCP Server]
+    C --> MCP
+    A --> MCP
+```
+
+| Client | Transport | Status |
+|--------|-----------|--------|
+| [Kiro CLI](https://github.com/aws/kiro) | stdio | ✅ getestet |
+| [Claude Desktop](https://claude.ai/download) | stdio | ✅ getestet |
+| Jeder MCP-Client | stdio / StreamableHTTP | ✅ kompatibel |
+
+## Features
+
+Verwalte Linux-Server per SSH — direkt aus dem KI-Assistenten heraus. Keine Agents, Daemons oder Tools auf den Zielservern nötig. Nur ein SSH-Zugang reicht.
+
+```mermaid
+graph LR
+    AI[KI-Assistent] -->|MCP| S[SSH MCP Server]
+    S -->|SSH/SFTP| R1[Server 1]
+    S -->|SSH/SFTP| R2[Server 2]
+    S -->|SSH/SFTP| RN[Server N]
+```
+
+- **Agentless**: Kein Setup auf den Zielservern — funktioniert mit jedem SSH-Zugang
+- **Remote Command Execution**: Einzelbefehle oder mehrzeilige Scripts ausführen
+- **Sudo Support**: Befehle mit `sudo` ausführen, ohne interaktives Passwort
+- **File Operations**: Dateien lesen (teilweise/komplett), schreiben, suchen, chirurgisch editieren
+- **File Transfer**: Upload/Download via SFTP
+- **Service Management**: Systemd Services starten, stoppen, restarten, Status prüfen
+- **Code Navigation**: Funktions-/Klassen-Übersicht aus Quelldateien extrahieren (grep-basiert, kein Language Server nötig)
+- **Multi-Server**: Beliebig viele Server parallel verwalten
+- **Connection Pooling**: SSH-Verbindungen werden 5 Minuten wiederverwendet
+- **User Approval**: Schreibende Operationen erfordern Bestätigung durch den Operator
+- **Audit Log**: Alle Aktionen werden protokolliert (Pfad konfigurierbar)
+
+## Installation
+
+### Von PyPI
+
+```bash
+pip install remote-admin-mcp
+```
+
+### Mit uv (empfohlen für Entwicklung)
+
+```bash
+# Virtuelle Umgebung erstellen und Abhängigkeiten installieren
+uv venv
+source .venv/bin/activate  # Windows: .venv\Scripts\activate
+uv pip install -e ".[dev]"
+```
+
+### Mit pip
+
+```bash
+# Virtuelle Umgebung erstellen
+python -m venv .venv
+source .venv/bin/activate  # Windows: .venv\Scripts\activate
+
+# Abhängigkeiten installieren
+pip install -e ".[dev]"
+```
+
+## Konfiguration
+
+1. Kopiere `.env.example` zu `.env`:
+```bash
+cp .env.example .env
+```
+
+2. Bearbeite `.env` mit deinen Server-Zugangsdaten:
+```bash
+SSH_SERVER_1_NAME=production
+SSH_SERVER_1_HOST=prod.example.com
+SSH_SERVER_1_PORT=22
+SSH_SERVER_1_USER=admin
+SSH_SERVER_1_PASSWORD=your-password
+
+SSH_SERVER_2_NAME=staging
+SSH_SERVER_2_HOST=staging.example.com
+SSH_SERVER_2_PORT=22
+SSH_SERVER_2_USER=deploy
+SSH_SERVER_2_PASSWORD=your-password
+```
+
+## MCP Tools
+
+### list_servers
+Liste alle konfigurierten Server auf.
+
+### execute_command
+Führe einen Befehl auf einem Remote-Server aus.
+
+**Parameter:**
+- `server` (string): Server-Name
+- `command` (string): Auszuführender Befehl
+- `use_sudo` (boolean): Mit sudo ausführen
+
+### read_file
+Lese eine Datei vom Remote-Server.
+
+**Parameter:**
+- `server` (string): Server-Name
+- `path` (string): Dateipfad
+
+### write_file
+Schreibe eine Datei auf den Remote-Server.
+
+**Parameter:**
+- `server` (string): Server-Name
+- `path` (string): Dateipfad
+- `content` (string): Dateiinhalt
+
+### get_service_status
+Prüfe den Status eines systemd Services.
+
+**Parameter:**
+- `server` (string): Server-Name
+- `service` (string): Service-Name
+
+### manage_service
+Verwalte einen systemd Service (start/stop/restart/reload).
+
+**Parameter:**
+- `server` (string): Server-Name
+- `service` (string): Service-Name
+- `action` (string): Aktion (start/stop/restart/reload)
+
+## Verwendung mit KI-Assistenten
+
+### Kiro CLI / Claude Desktop (uvx — empfohlen)
+
+Kein manuelles Installieren nötig — `uvx` lädt und cached das Paket automatisch:
+
+```json
+{
+  "mcpServers": {
+    "ssh": {
+      "command": "uvx",
+      "args": ["remote-admin-mcp"],
+      "env": {
+        "SSH_SERVER_1_NAME": "production",
+        "SSH_SERVER_1_HOST": "prod.example.com",
+        "SSH_SERVER_1_USER": "admin",
+        "SSH_SERVER_1_KEY_FILE": "~/.ssh/id_ed25519"
+      }
+    }
+  }
+}
+```
+
+### Alternative: Mit .env-Datei
+
+```json
+{
+  "mcpServers": {
+    "ssh": {
+      "command": "uvx",
+      "args": ["--env-file", "/path/to/.env", "remote-admin-mcp"]
+    }
+  }
+}
+```
+
+### Alternative: Lokale Installation
+
+```json
+{
+  "mcpServers": {
+    "ssh": {
+      "command": "/path/to/.venv/bin/ssh_mcp_server"
+    }
+  }
+}
+```
+
+## Beispiele
+
+**Log-Analyse:**
+```
+"Zeige mir die letzten 100 Zeilen vom nginx error log auf production"
+```
+
+**Service Restart:**
+```
+"Starte den nginx Service auf staging neu"
+```
+
+**Config ändern:**
+```
+"Lies die nginx.conf auf production und erhöhe worker_processes auf 4"
+```
+
+## Sicherheit
+
+- Schreibende Tools erfordern **User-Approval** durch den MCP Client
+- Lese-Tools (`list_servers`, `read_file`, `search_in_file`, `get_file_structure`) sind auto-approved
+- SSH-Key-Authentifizierung empfohlen (Passwort-Auth möglich)
+- `.env` sollte NICHT ins Git committed werden
+
+### Audit Log
+
+Alle Aktionen werden in ein Logfile geschrieben:
+
+```
+[2026-04-12 13:14:00] [production] execute: tail -100 /var/log/syslog
+[2026-04-12 13:14:05] [production] write_file: /etc/nginx/nginx.conf — Config update
+```
+
+Default: `~/.ssh-mcp-audit.log`. Konfigurierbar per Environment-Variable:
+
+```bash
+SSH_MCP_AUDIT_LOG=/var/log/ssh-mcp-audit.log
+```
+
+## Entwicklung
+
+```bash
+# Tests ausführen
+pytest -v
+
+# Linting
+ruff check src/
+```
+
+## Lizenz
+
+MIT — siehe [LICENSE](LICENSE)