MUA: Echte Unraid-Plugin-Struktur
- plugin/mua.plg: <!DOCTYPE PLUGIN> XML mit <FILE Run> + <INLINE> - plugin/plugin.json: Metadaten - scripts/rc.mua: SysVinit-Service (statt systemd) - scripts/plugin.php: WebGUI-Tab (Settings > MUA) - README.md: Aktualisiert - Alte Dateien entfernt (MUA.plg, mua.service, install/update/remove.sh)
This commit is contained in:
Mikei386
@@ -1,71 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<Plugin>
|
||||
<Name>mua</Name>
|
||||
<Version>1.0.0</Version>
|
||||
<Release>1</Release>
|
||||
<Arch>x86_64</Arch>
|
||||
<Url>https://git-192.168.1.2:33/michael/MUA-Mikes-Unraid-Agent</Url>
|
||||
<Summary>MUA - Mikes Unraid Agent (MCP Server)</Summary>
|
||||
<Description>MUA (Mikes Unraid Agent) is a native Unraid plugin that exposes 21 Docker, network, and system tools as an MCP (Model Context Protocol) server over HTTP (Streamable HTTP transport). Runs locally on the Unraid host - no SSH required. Endpoint: http://<unraid-ip>:3002/mcp</Description>
|
||||
<Author>Michael</Author>
|
||||
<License>MIT</License>
|
||||
<Categories>
|
||||
<Category>Tools</Category>
|
||||
</Categories>
|
||||
<Files>
|
||||
<File>
|
||||
<Name>mcp/server.php</Name>
|
||||
<Path>/usr/local/plugins/mua/mcp/</Path>
|
||||
<Mode>0644</Mode>
|
||||
</File>
|
||||
<File>
|
||||
<Name>mcp/helpers.php</Name>
|
||||
<Path>/usr/local/plugins/mua/mcp/</Path>
|
||||
<Mode>0644</Mode>
|
||||
</File>
|
||||
<File>
|
||||
<Name>mcp/tools.php</Name>
|
||||
<Path>/usr/local/plugins/mua/mcp/</Path>
|
||||
<Mode>0644</Mode>
|
||||
</File>
|
||||
<File>
|
||||
<Name>scripts/unraid-docker-mcp-helper.php</Name>
|
||||
<Path>/usr/local/plugins/mua/scripts/</Path>
|
||||
<Mode>0755</Mode>
|
||||
</File>
|
||||
<File>
|
||||
<Name>scripts/mua.service</Name>
|
||||
<Path>/usr/local/plugins/mua/scripts/</Path>
|
||||
<Mode>0644</Mode>
|
||||
</File>
|
||||
<File>
|
||||
<Name>scripts/install.sh</Name>
|
||||
<Path>/usr/local/plugins/mua/scripts/</Path>
|
||||
<Mode>0755</Mode>
|
||||
</File>
|
||||
<File>
|
||||
<Name>scripts/update.sh</Name>
|
||||
<Path>/usr/local/plugins/mua/scripts/</Path>
|
||||
<Mode>0755</Mode>
|
||||
</File>
|
||||
<File>
|
||||
<Name>scripts/remove.sh</Name>
|
||||
<Path>/usr/local/plugins/mua/scripts/</Path>
|
||||
<Mode>0755</Mode>
|
||||
</File>
|
||||
</Files>
|
||||
<Actions>
|
||||
<Action>
|
||||
<Name>install</Name>
|
||||
<Script>scripts/install.sh</Script>
|
||||
</Action>
|
||||
<Action>
|
||||
<Name>update</Name>
|
||||
<Script>scripts/update.sh</Script>
|
||||
</Action>
|
||||
<Action>
|
||||
<Name>remove</Name>
|
||||
<Script>scripts/remove.sh</Script>
|
||||
</Action>
|
||||
</Actions>
|
||||
</Plugin>
|
||||
@@ -1,139 +1,101 @@
|
||||
# MUA — Mikes Unraid Agent
|
||||
|
||||
Natives Unraid-Plugin, das 21 Docker-, Netzwerk- und System-Tools als **MCP-Server** (Model Context Protocol) über **HTTP (Streamable HTTP)** exponiert.
|
||||
|
||||
Läuft **lokal auf dem Unraid-Host** — kein SSH, kein Proxy, kein Key-Management.
|
||||
|
||||
## Endpunkt
|
||||
|
||||
```
|
||||
http://<unraid-ip>:3002/mcp
|
||||
```
|
||||
|
||||
- **POST** `/mcp` — JSON-RPC 2.0 (MCP-Requests)
|
||||
- **GET** `/health` — Health-Check
|
||||
- **DELETE** `/mcp` — Session-End
|
||||
|
||||
## Tools (21)
|
||||
|
||||
### Docker (14)
|
||||
| Tool | Beschreibung |
|
||||
|------|-------------|
|
||||
| `unraid_docker_list` | Alle Container mit Runtime-Stats |
|
||||
| `unraid_docker_inspect` | Container-Details |
|
||||
| `unraid_docker_logs` | Container-Logs |
|
||||
| `unraid_docker_analyze_logs` | Log-Analyse (server-seitig) |
|
||||
| `unraid_docker_processes` | Prozesse im Container |
|
||||
| `unraid_docker_stats` | Live-Stats (CPU/RAM/Net) |
|
||||
| `unraid_docker_info` | Docker-Daemon-Info |
|
||||
| `unraid_docker_start` | Container starten |
|
||||
| `unraid_docker_stop` | Container stoppen |
|
||||
| `unraid_docker_restart` | Container neu starten |
|
||||
| `unraid_docker_create` | Container aus Template |
|
||||
| `unraid_docker_modify` | Template ändern |
|
||||
| `unraid_docker_update` | Container aktualisieren |
|
||||
| `unraid_docker_rebuild` | Container neu bauen |
|
||||
|
||||
### Netzwerk (6)
|
||||
| Tool | Beschreibung |
|
||||
|------|-------------|
|
||||
| `unraid_network_inventory` | Netzwerk-Inventur |
|
||||
| `unraid_network_list` | Alle Netzwerke |
|
||||
| `unraid_network_inspect` | Netzwerk-Details |
|
||||
| `unraid_network_host_state` | Host-Netzwerk-Zustand |
|
||||
| `unraid_network_audit_tcp` | TCP-Endpunkte auditieren |
|
||||
| `unraid_network_lan_probe` | Dualstack-Probe |
|
||||
|
||||
### System (1)
|
||||
| Tool | Beschreibung |
|
||||
|------|-------------|
|
||||
| `unraid_system_connection_test` | Verbindungstest |
|
||||
|
||||
## Installation
|
||||
|
||||
### Via Community Apps (Link)
|
||||
1. Community Apps öffnen
|
||||
2. "Add Plugin" → Link: `https://git-192.168.1.2:33/michael/MUA-Mikes-Unraid-Agent`
|
||||
3. Installieren
|
||||
|
||||
### Manuell
|
||||
```bash
|
||||
# Dateien kopieren
|
||||
mkdir -p /usr/local/plugins/mua
|
||||
cp -r mcp scripts /usr/local/plugins/mua/
|
||||
|
||||
# Helper installieren
|
||||
cp scripts/unraid-docker-mcp-helper.php /usr/local/bin/
|
||||
chmod 755 /usr/local/bin/unraid-docker-mcp-helper.php
|
||||
|
||||
# Service installieren
|
||||
cp scripts/mua.service /etc/systemd/system/
|
||||
systemctl daemon-reload
|
||||
systemctl enable --now mua.service
|
||||
|
||||
# Health-Check
|
||||
curl http://127.0.0.1:3002/health
|
||||
```
|
||||
|
||||
## Anbindung an MCP-Client
|
||||
|
||||
### Beispiel: Hermes Agent (config.yaml)
|
||||
```yaml
|
||||
mcp_servers:
|
||||
mua:
|
||||
url: http://192.168.1.2:3002/mcp
|
||||
transport: http
|
||||
```
|
||||
|
||||
### Beispiel: curl
|
||||
```bash
|
||||
# Initialize
|
||||
curl -X POST http://192.168.1.2:3002/mcp \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
|
||||
|
||||
# Tools auflisten
|
||||
curl -X POST http://192.168.1.2:3002/mcp \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "Mcp-Session-Id: <session-id>" \
|
||||
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
|
||||
|
||||
# Tool aufrufen
|
||||
curl -X POST http://192.168.1.2:3002/mcp \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "Mcp-Session-Id: <session-id>" \
|
||||
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"unraid_docker_list","arguments":{}}}'
|
||||
```
|
||||
|
||||
## Selftest
|
||||
|
||||
```bash
|
||||
php /usr/local/plugins/mua/mcp/selftest.php
|
||||
```
|
||||
Natives Unraid-Plugin: 21 Docker-, Netzwerk- und System-Tools als MCP-Server (Streamable HTTP) auf Port 3002.
|
||||
|
||||
## Architektur
|
||||
|
||||
```
|
||||
MCP-Client (z.B. llama.cpp auf 196)
|
||||
│
|
||||
│ HTTP (Streamable HTTP)
|
||||
▼
|
||||
http://192.168.1.2:3002/mcp (MUA Plugin auf Unraid)
|
||||
│
|
||||
│ lokal (kein SSH)
|
||||
▼
|
||||
/usr/bin/docker, /usr/bin/ip, /usr/bin/ss, /usr/bin/php
|
||||
llama.cpp (196) → HTTP → http://192.168.1.2:3002/mcp (MUA Plugin auf Unraid)
|
||||
```
|
||||
|
||||
## Port
|
||||
Kein SSH, kein Proxy, kein Key-Management (nur URL + API-Key).
|
||||
|
||||
- **3002** (3000 ist belegt von `theippenguin/unraid-mcp`)
|
||||
## Unraid-Plugin-Struktur
|
||||
|
||||
## Git
|
||||
```
|
||||
MUA-Mikes-Unraid-Agent/
|
||||
├── plugin/
|
||||
│ ├── mua.plg # Unraid-Plugin-File (XML, <!DOCTYPE PLUGIN>)
|
||||
│ └── plugin.json # Metadaten (Name, Version, Pfade)
|
||||
├── mcp/
|
||||
│ ├── server.php # MCP-Server (Streamable HTTP, JSON-RPC 2.0)
|
||||
│ ├── helpers.php # Helper-Funktionen (Docker, Netzwerk, System)
|
||||
│ ├── tools.php # 21 Tool-Definitionen
|
||||
│ └── selftest.php # Selftest (12 Tests)
|
||||
├── scripts/
|
||||
│ ├── rc.mua # SysVinit-Service-Script
|
||||
│ ├── plugin.php # WebGUI-Tab (Settings > MUA)
|
||||
│ └── unraid-docker-mcp-helper.php # Write-Operationen (DockerClient)
|
||||
└── README.md
|
||||
```
|
||||
|
||||
- Repo: `michael/MUA-Mikes-Unraid-Agent.git`
|
||||
- Zugang: `git@192.168.1.2:33` (SSH-Key `ha_agent`)
|
||||
- Updates: Neuer Commit + Push
|
||||
## Installation
|
||||
|
||||
### Über Unraid-Plugin-Installer
|
||||
|
||||
```bash
|
||||
# .plg-File herunterladen und installieren
|
||||
wget -O /tmp/mua.plg "http://192.168.1.2:4000/michael/MUA-Mikes-Unraid-Agent/raw/branch/main/plugin/mua.plg"
|
||||
# Im Unraid-WebGUI: Settings > Plugins > Install from URL
|
||||
# URL: http://192.168.1.2:4000/michael/MUA-Mikes-Unraid-Agent/raw/branch/main/plugin/mua.plg
|
||||
```
|
||||
|
||||
### Manuell
|
||||
|
||||
```bash
|
||||
# Repo klonen
|
||||
git clone git@192.168.1.2:33/michael/MUA-Mikes-Unraid-Agent.git /tmp/mua
|
||||
|
||||
# Dateien installieren
|
||||
mkdir -p /usr/local/emhttp/plugins/mua/{mcp,scripts}
|
||||
cp /tmp/mua/mcp/*.php /usr/local/emhttp/plugins/mua/mcp/
|
||||
cp /tmp/mua/scripts/plugin.php /usr/local/emhttp/plugins/mua/
|
||||
cp /tmp/mua/scripts/rc.mua /etc/rc.d/rc.mua
|
||||
chmod 755 /etc/rc.d/rc.mua
|
||||
cp /tmp/mua/scripts/unraid-docker-mcp-helper.php /usr/local/bin/
|
||||
chmod 755 /usr/local/bin/unraid-docker-mcp-helper.php
|
||||
|
||||
# Selftest
|
||||
php /usr/local/emhttp/plugins/mua/mcp/selftest.php
|
||||
|
||||
# Starten
|
||||
/etc/rc.d/rc.mua start
|
||||
```
|
||||
|
||||
## Verwaltung
|
||||
|
||||
| Aktion | Befehl |
|
||||
|---|---|
|
||||
| Starten | `/etc/rc.d/rc.mua start` |
|
||||
| Stoppen | `/etc/rc.d/rc.mua stop` |
|
||||
| Neu starten | `/etc/rc.d/rc.mua restart` |
|
||||
| Status | `/etc/rc.d/rc.mua status` |
|
||||
| Logs | `tail -f /var/log/plugins/mua.log` |
|
||||
| WebGUI | Settings > MUA |
|
||||
|
||||
## MCP-Endpunkt
|
||||
|
||||
- **URL:** `http://<unraid-ip>:3002/mcp`
|
||||
- **Transport:** Streamable HTTP (POST-only)
|
||||
- **Protokoll:** JSON-RPC 2.0
|
||||
- **Session:** `Mcp-Session-Id` Header
|
||||
|
||||
## Tools (21)
|
||||
|
||||
| Kategorie | Tools |
|
||||
|---|---|
|
||||
| **Docker (14)** | list, inspect, logs, analyze_logs, processes, stats, info, start, stop, restart, create, modify, update, rebuild |
|
||||
| **Netzwerk (6)** | inventory, list, inspect, host_state, audit_tcp, lan_probe |
|
||||
| **System (1)** | connection_test |
|
||||
|
||||
## Konformität
|
||||
|
||||
- ✅ Echte Unraid-Plugin-Struktur (`<!DOCTYPE PLUGIN>`, `<FILE Run="/bin/bash">` + `<INLINE>`)
|
||||
- ✅ SysVinit-Service (`/etc/rc.d/rc.mua`) statt systemd
|
||||
- ✅ WebGUI-Tab (`launch="Settings/MUA"`)
|
||||
- ✅ Standard-Pfade (`/usr/local/emhttp/plugins/mua`, `/boot/config/plugins/mua`)
|
||||
- ✅ Selftest (12/12)
|
||||
- ✅ PHP 8.4-kompatibel
|
||||
|
||||
## Lizenz
|
||||
|
||||
|
||||
+147
@@ -0,0 +1,147 @@
|
||||
<?xml version='1.0' standalone='yes'?>
|
||||
<!DOCTYPE PLUGIN>
|
||||
|
||||
<PLUGIN
|
||||
name="mua"
|
||||
author="Michael"
|
||||
version="1.0.0"
|
||||
pluginURL="http://192.168.1.2:4000/michael/MUA-Mikes-Unraid-Agent/raw/branch/main/plugin/mua.plg"
|
||||
launch="Settings/MUA"
|
||||
support="http://192.168.1.2:4000/michael/MUA-Mikes-Unraid-Agent"
|
||||
min="7.0.0"
|
||||
>
|
||||
|
||||
<CHANGES>
|
||||
<![CDATA[
|
||||
###1.0.0###
|
||||
Initial release: 21 Docker, network, and system tools as MCP server over HTTP (Streamable HTTP, port 3002).
|
||||
]]>
|
||||
</CHANGES>
|
||||
|
||||
<!--
|
||||
Install script.
|
||||
Klon das Git-Repo und installiert alle Dateien.
|
||||
-->
|
||||
<FILE Run="/bin/bash">
|
||||
<INLINE>
|
||||
set -e
|
||||
|
||||
PLUGIN_DIR="/usr/local/emhttp/plugins/mua"
|
||||
CONFIG_DIR="/boot/config/plugins/mua"
|
||||
GIT_REPO="git@192.168.1.2:33/michael/MUA-Mikes-Unraid-Agent.git"
|
||||
TMP_DIR="/tmp/mua-install-$$"
|
||||
|
||||
echo ""
|
||||
echo "===================================================="
|
||||
echo " MUA - Mikes Unraid Agent"
|
||||
echo " Installation"
|
||||
echo "===================================================="
|
||||
echo ""
|
||||
|
||||
# 1. Verzeichnisse
|
||||
mkdir -p "$PLUGIN_DIR/mcp"
|
||||
mkdir -p "$PLUGIN_DIR/scripts"
|
||||
mkdir -p "$CONFIG_DIR"
|
||||
|
||||
# 2. Git-Repo klonen
|
||||
echo " Kloniere Repo..."
|
||||
git clone --depth 1 "$GIT_REPO" "$TMP_DIR" 2>&1 | sed 's/^/ /'
|
||||
|
||||
# 3. PHP-Dateien installieren
|
||||
echo " Installiere MCP-Server..."
|
||||
cp "$TMP_DIR/mcp/server.php" "$PLUGIN_DIR/mcp/"
|
||||
cp "$TMP_DIR/mcp/helpers.php" "$PLUGIN_DIR/mcp/"
|
||||
cp "$TMP_DIR/mcp/tools.php" "$PLUGIN_DIR/mcp/"
|
||||
cp "$TMP_DIR/mcp/selftest.php" "$PLUGIN_DIR/mcp/"
|
||||
chmod 644 "$PLUGIN_DIR/mcp/"*.php
|
||||
|
||||
# 4. PHP-Helper (Write-Operationen)
|
||||
echo " Installiere PHP-Helper..."
|
||||
cp "$TMP_DIR/scripts/unraid-docker-mcp-helper.php" /usr/local/bin/
|
||||
chmod 755 /usr/local/bin/unraid-docker-mcp-helper.php
|
||||
|
||||
# 5. WebGUI-Tab
|
||||
echo " Installiere WebGUI-Tab..."
|
||||
cp "$TMP_DIR/scripts/plugin.php" "$PLUGIN_DIR/plugin.php"
|
||||
chmod 644 "$PLUGIN_DIR/plugin.php"
|
||||
|
||||
# 6. SysVinit-Service
|
||||
echo " Installiere Service..."
|
||||
cp "$TMP_DIR/scripts/rc.mua" /etc/rc.d/rc.mua
|
||||
chmod 755 /etc/rc.d/rc.mua
|
||||
|
||||
# 7. Log-Verzeichnis
|
||||
mkdir -p /var/log/plugins
|
||||
touch /var/log/plugins/mua.log
|
||||
|
||||
# 8. Selftest
|
||||
echo " Führe Selftest aus..."
|
||||
php "$PLUGIN_DIR/mcp/selftest.php" 2>&1 | sed 's/^/ /'
|
||||
|
||||
# 9. Service starten
|
||||
echo " Starte MCP-Server..."
|
||||
/etc/rc.d/rc.mua start
|
||||
|
||||
# 10. Health-Check
|
||||
sleep 2
|
||||
if curl -sf "http://127.0.0.1:3002/health" > /dev/null 2>&1; then
|
||||
echo ""
|
||||
echo " Health-Check: OK"
|
||||
echo ""
|
||||
echo "===================================================="
|
||||
echo " MUA installiert und läuft auf Port 3002"
|
||||
echo " Endpunkt: http://$(hostname -I | awk '{print $1}'):3002/mcp"
|
||||
echo " WebGUI: Settings > MUA"
|
||||
echo "===================================================="
|
||||
else
|
||||
echo ""
|
||||
echo " WARNUNG: Health-Check fehlgeschlagen"
|
||||
echo " Logs: tail -f /var/log/plugins/mua.log"
|
||||
echo "===================================================="
|
||||
fi
|
||||
|
||||
# 11. Cleanup
|
||||
rm -rf "$TMP_DIR"
|
||||
|
||||
</INLINE>
|
||||
</FILE>
|
||||
|
||||
<!--
|
||||
Remove script.
|
||||
-->
|
||||
<FILE Run="/bin/bash" Method="remove">
|
||||
<INLINE>
|
||||
echo ""
|
||||
echo "===================================================="
|
||||
echo " MUA - Mikes Unraid Agent"
|
||||
echo " Deinstallation"
|
||||
echo "===================================================="
|
||||
echo ""
|
||||
|
||||
# 1. Service stoppen
|
||||
/etc/rc.d/rc.mua stop 2>/dev/null || true
|
||||
|
||||
# 2. Service-Datei entfernen
|
||||
rm -f /etc/rc.d/rc.mua
|
||||
|
||||
# 3. PHP-Helper entfernen
|
||||
rm -f /usr/local/bin/unraid-docker-mcp-helper.php
|
||||
|
||||
# 4. Plugin-Verzeichnis entfernen
|
||||
rm -rf /usr/local/emhttp/plugins/mua
|
||||
|
||||
# 5. Config entfernen
|
||||
rm -rf /boot/config/plugins/mua
|
||||
|
||||
# 6. Logs entfernen
|
||||
rm -f /var/log/plugins/mua.log
|
||||
rm -f /var/run/mua.pid
|
||||
|
||||
echo ""
|
||||
echo " MUA wurde deinstalliert."
|
||||
echo "===================================================="
|
||||
|
||||
</INLINE>
|
||||
</FILE>
|
||||
|
||||
</PLUGIN>
|
||||
@@ -0,0 +1,9 @@
|
||||
{
|
||||
"name": "mua",
|
||||
"author": "Michael",
|
||||
"version": "1.0.0",
|
||||
"minver": "7.0.0",
|
||||
"pluginDirectory": "/usr/local/emhttp/plugins/mua",
|
||||
"configDirectory": "/boot/config/plugins/mua",
|
||||
"port": 3002
|
||||
}
|
||||
@@ -1,49 +0,0 @@
|
||||
#!/bin/bash
|
||||
# MUA - Mikes Unraid Agent
|
||||
# Install-Script
|
||||
# Wird vom Unraid-Plugin-Installer aufgerufen.
|
||||
|
||||
set -e
|
||||
|
||||
PLUGIN_DIR="/usr/local/plugins/mua"
|
||||
SERVICE_FILE="$PLUGIN_DIR/scripts/mua.service"
|
||||
HELPER_SRC="$PLUGIN_DIR/scripts/unraid-docker-mcp-helper.php"
|
||||
HELPER_DST="/usr/local/bin/unraid-docker-mcp-helper.php"
|
||||
|
||||
echo "=== MUA Install ==="
|
||||
|
||||
# 1. Verzeichnisse sicherstellen
|
||||
mkdir -p "$PLUGIN_DIR/mcp"
|
||||
mkdir -p "$PLUGIN_DIR/scripts"
|
||||
|
||||
# 2. PHP-Helper installieren (Write-Operationen)
|
||||
if [ -f "$HELPER_SRC" ]; then
|
||||
cp "$HELPER_SRC" "$HELPER_DST"
|
||||
chmod 755 "$HELPER_DST"
|
||||
echo " Helper installiert: $HELPER_DST"
|
||||
fi
|
||||
|
||||
# 3. systemd-Service installieren
|
||||
if [ -f "$SERVICE_FILE" ]; then
|
||||
cp "$SERVICE_FILE" /etc/systemd/system/mua.service
|
||||
chmod 644 /etc/systemd/system/mua.service
|
||||
systemctl daemon-reload
|
||||
echo " Service installiert: mua.service"
|
||||
fi
|
||||
|
||||
# 4. Service starten + enable
|
||||
systemctl enable mua.service
|
||||
systemctl restart mua.service
|
||||
|
||||
# 5. Health-Check
|
||||
sleep 2
|
||||
if curl -sf "http://127.0.0.1:3002/health" > /dev/null 2>&1; then
|
||||
echo " Health-Check: OK"
|
||||
echo "=== MUA installiert und läuft auf Port 3002 ==="
|
||||
echo " Endpunkt: http://$(hostname -I | awk '{print $1}'):3002/mcp"
|
||||
else
|
||||
echo " WARNUNG: Health-Check fehlgeschlagen"
|
||||
echo " Service-Status:"
|
||||
systemctl status mua.service --no-pager || true
|
||||
exit 1
|
||||
fi
|
||||
@@ -1,20 +0,0 @@
|
||||
[Unit]
|
||||
Description=MUA - Mikes Unraid Agent (MCP Server)
|
||||
After=network.target docker.service
|
||||
Wants=docker.service
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
# PHP Built-in Server auf Port 3002
|
||||
ExecStart=/usr/bin/php -S 0.0.0.0:3002 /usr/local/plugins/mua/mcp/server.php
|
||||
Restart=on-failure
|
||||
RestartSec=5
|
||||
# Arbeitsverzeichnis
|
||||
WorkingDirectory=/usr/local/plugins/mua
|
||||
# Sicherheits-Härtung
|
||||
NoNewPrivileges=true
|
||||
ProtectHome=true
|
||||
PrivateTmp=true
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
@@ -0,0 +1,117 @@
|
||||
<?php
|
||||
/**
|
||||
* MUA - Mikes Unraid Agent
|
||||
* WebGUI-Tab (plugin.php)
|
||||
* Wird vom Unraid-WebGUI geladen, wenn der Tab "Settings/MUA" geöffnet wird.
|
||||
* Zeigt Status, Endpunkt und Health-Check.
|
||||
*/
|
||||
|
||||
$plugin_dir = '/usr/local/emhttp/plugins/mua';
|
||||
$port = 3002;
|
||||
$pidfile = '/var/run/mua.pid';
|
||||
$endpoint = 'http://' . ($_SERVER['SERVER_ADDR'] ?? '127.0.0.1') . ':' . $port . '/mcp';
|
||||
|
||||
// Status bestimmen
|
||||
$running = false;
|
||||
$pid = null;
|
||||
if (file_exists($pidfile)) {
|
||||
$pid = trim(file_get_contents($pidfile));
|
||||
if ($pid && is_numeric($pid) && @posix_kill((int)$pid, 0)) {
|
||||
$running = true;
|
||||
}
|
||||
}
|
||||
|
||||
// Health-Check
|
||||
$health = null;
|
||||
$ch = curl_init('http://127.0.0.1:' . $port . '/health');
|
||||
curl_setopt_array($ch, [
|
||||
CURLOPT_RETURNTRANSFER => true,
|
||||
CURLOPT_TIMEOUT => 3,
|
||||
CURLOPT_CONNECTTIMEOUT => 2,
|
||||
]);
|
||||
$health = curl_exec($ch);
|
||||
$health_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
|
||||
curl_close($ch);
|
||||
$health_ok = ($health_code === 200);
|
||||
|
||||
// PHP-Version
|
||||
$php_version = PHP_VERSION;
|
||||
|
||||
// Tool-Anzahl (aus tools.php)
|
||||
$tool_count = 21;
|
||||
|
||||
// Host-IP
|
||||
$host_ip = $_SERVER['SERVER_ADDR'] ?? '127.0.0.1';
|
||||
?>
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>MUA - Mikes Unraid Agent</title>
|
||||
<style>
|
||||
body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; margin: 20px; color: #333; }
|
||||
h1 { font-size: 1.5em; border-bottom: 2px solid #4a90d9; padding-bottom: 8px; }
|
||||
.status { padding: 12px 16px; border-radius: 6px; margin: 12px 0; font-size: 0.95em; }
|
||||
.status.ok { background: #e8f5e9; border: 1px solid #4caf50; color: #2e7d32; }
|
||||
.status.err { background: #ffebee; border: 1px solid #f44336; color: #c62828; }
|
||||
.status.warn { background: #fff3e0; border: 1px solid #ff9800; color: #e65100; }
|
||||
table { border-collapse: collapse; margin: 12px 0; }
|
||||
td, th { padding: 8px 12px; border: 1px solid #ddd; text-align: left; }
|
||||
th { background: #f5f5f5; font-weight: 600; }
|
||||
code { background: #f5f5f5; padding: 2px 6px; border-radius: 3px; font-size: 0.9em; }
|
||||
.endpoint { font-size: 1.1em; color: #4a90d9; font-weight: 600; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<h1>MUA - Mikes Unraid Agent</h1>
|
||||
|
||||
<?php if ($running): ?>
|
||||
<div class="status ok">✅ <strong>MCP-Server läuft</strong> (PID <?= $pid ?>, Port <?= $port ?>)</div>
|
||||
<?php else: ?>
|
||||
<div class="status err">❌ <strong>MCP-Server läuft nicht</strong> — starte mit <code>/etc/rc.d/rc.mua start</code></div>
|
||||
<?php endif; ?>
|
||||
|
||||
<?php if ($health_ok): ?>
|
||||
<div class="status ok">✅ Health-Check: OK</div>
|
||||
<?php elseif ($health !== false): ?>
|
||||
<div class="status warn">⚠️ Health-Check: HTTP <?= $health_code ?></div>
|
||||
<?php else: ?>
|
||||
<div class="status warn">⚠️ Health-Check: nicht erreichbar</div>
|
||||
<?php endif; ?>
|
||||
|
||||
<h2>MCP-Endpunkt</h2>
|
||||
<p class="endpoint"><?= $endpoint ?></p>
|
||||
<p>Transport: <code>Streamable HTTP</code> (POST-only) · JSON-RPC 2.0</p>
|
||||
|
||||
<h2>Details</h2>
|
||||
<table>
|
||||
<tr><th>Plugin</th><td>MUA (Mikes Unraid Agent)</td></tr>
|
||||
<tr><th>Version</th><td>1.0.0</td></tr>
|
||||
<tr><th>PHP</th><td><?= $php_version ?></td></tr>
|
||||
<tr><th>Port</th><td><?= $port ?></td></tr>
|
||||
<tr><th>Host-IP</th><td><?= $host_ip ?></td></tr>
|
||||
<tr><th>Tools</th><td><?= $tool_count ?> (Docker: 14, Netzwerk: 6, System: 1)</td></tr>
|
||||
<tr><th>Plugin-Verzeichnis</th><td><code><?= $plugin_dir ?></code></td></tr>
|
||||
<tr><th>Service</th><td><code>/etc/rc.d/rc.mua</code> (SysVinit)</td></tr>
|
||||
</table>
|
||||
|
||||
<h2>Verwaltung</h2>
|
||||
<table>
|
||||
<tr><th>Aktion</th><th>Befehl</th></tr>
|
||||
<tr><td>Starten</td><td><code>/etc/rc.d/rc.mua start</code></td></tr>
|
||||
<tr><td>Stoppen</td><td><code>/etc/rc.d/rc.mua stop</code></td></tr>
|
||||
<tr><td>Neu starten</td><td><code>/etc/rc.d/rc.mua restart</code></td></tr>
|
||||
<tr><td>Status</td><td><code>/etc/rc.d/rc.mua status</code></td></tr>
|
||||
<tr><td>Logs</td><td><code>tail -f /var/log/plugins/mua.log</code></td></tr>
|
||||
</table>
|
||||
|
||||
<h2>Tools</h2>
|
||||
<table>
|
||||
<tr><th>Kategorie</th><th>Tools</th></tr>
|
||||
<tr><td>Docker (14)</td><td>list, inspect, logs, analyze_logs, processes, stats, info, start, stop, restart, create, modify, update, rebuild</td></tr>
|
||||
<tr><td>Netzwerk (6)</td><td>inventory, list, inspect, host_state, audit_tcp, lan_probe</td></tr>
|
||||
<tr><td>System (1)</td><td>connection_test</td></tr>
|
||||
</table>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,83 @@
|
||||
#!/bin/bash
|
||||
# MUA - Mikes Unraid Agent
|
||||
# SysVinit-Service-Script (rc.mua)
|
||||
# Unraid nutzt SysVinit, kein systemd.
|
||||
# Wird installiert nach /etc/rc.d/rc.mua
|
||||
|
||||
PLUGIN_DIR="/usr/local/emhttp/plugins/mua"
|
||||
SERVER="$PLUGIN_DIR/mcp/server.php"
|
||||
PIDFILE="/var/run/mua.pid"
|
||||
LOGFILE="/var/log/plugins/mua.log"
|
||||
PORT=3002
|
||||
PHP_BIN="/usr/bin/php"
|
||||
|
||||
# PHP-Binary finden (Fallback)
|
||||
if [ ! -x "$PHP_BIN" ]; then
|
||||
PHP_BIN=$(command -v php 2>/dev/null)
|
||||
fi
|
||||
|
||||
start() {
|
||||
if [ -f "$PIDFILE" ] && kill -0 "$(cat "$PIDFILE")" 2>/dev/null; then
|
||||
echo " MUA läuft bereits (PID $(cat "$PIDFILE"))"
|
||||
return 0
|
||||
fi
|
||||
if [ ! -f "$SERVER" ]; then
|
||||
echo " FEHLER: Server-Datei nicht gefunden: $SERVER"
|
||||
return 1
|
||||
fi
|
||||
# Server starten (detached)
|
||||
nohup "$PHP_BIN" -S 0.0.0.0:$PORT "$SERVER" >> "$LOGFILE" 2>&1 &
|
||||
echo $! > "$PIDFILE"
|
||||
sleep 1
|
||||
if kill -0 "$(cat "$PIDFILE")" 2>/dev/null; then
|
||||
echo " MUA gestartet (PID $(cat "$PIDFILE"), Port $PORT)"
|
||||
return 0
|
||||
else
|
||||
echo " FEHLER: MUA konnte nicht gestartet werden"
|
||||
cat "$LOGFILE" 2>/dev/null | tail -5
|
||||
return 1
|
||||
fi
|
||||
}
|
||||
|
||||
stop() {
|
||||
if [ -f "$PIDFILE" ]; then
|
||||
local pid=$(cat "$PIDFILE")
|
||||
if kill -0 "$pid" 2>/dev/null; then
|
||||
kill "$pid" 2>/dev/null
|
||||
sleep 1
|
||||
kill -0 "$pid" 2>/dev/null && kill -9 "$pid" 2>/dev/null
|
||||
echo " MUA gestoppt (PID $pid)"
|
||||
fi
|
||||
rm -f "$PIDFILE"
|
||||
else
|
||||
# Fallback: per Port suchen
|
||||
local pid=$(lsof -ti :$PORT 2>/dev/null)
|
||||
if [ -n "$pid" ]; then
|
||||
kill "$pid" 2>/dev/null
|
||||
echo " MUA gestoppt (PID $pid, per Port)"
|
||||
else
|
||||
echo " MUA läuft nicht"
|
||||
fi
|
||||
fi
|
||||
}
|
||||
|
||||
status() {
|
||||
if [ -f "$PIDFILE" ] && kill -0 "$(cat "$PIDFILE")" 2>/dev/null; then
|
||||
echo " MUA läuft (PID $(cat "$PIDFILE"), Port $PORT)"
|
||||
return 0
|
||||
else
|
||||
echo " MUA läuft nicht"
|
||||
return 1
|
||||
fi
|
||||
}
|
||||
|
||||
case "$1" in
|
||||
start) start ;;
|
||||
stop) stop ;;
|
||||
restart) stop; start ;;
|
||||
status) status ;;
|
||||
*)
|
||||
echo "Usage: $0 {start|stop|restart|status}"
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
@@ -1,31 +0,0 @@
|
||||
#!/bin/bash
|
||||
# MUA - Mikes Unraid Agent
|
||||
# Remove-Script
|
||||
# Wird vom Unraid-Plugin-Installer bei Deinstallation aufgerufen.
|
||||
|
||||
set -e
|
||||
|
||||
echo "=== MUA Remove ==="
|
||||
|
||||
# 1. Service stoppen + disable
|
||||
if systemctl list-unit-files | grep -q "^mua.service"; then
|
||||
systemctl stop mua.service 2>/dev/null || true
|
||||
systemctl disable mua.service 2>/dev/null || true
|
||||
rm -f /etc/systemd/system/mua.service
|
||||
systemctl daemon-reload
|
||||
echo " Service entfernt"
|
||||
fi
|
||||
|
||||
# 2. PHP-Helper entfernen
|
||||
if [ -f "/usr/local/bin/unraid-docker-mcp-helper.php" ]; then
|
||||
rm -f /usr/local/bin/unraid-docker-mcp-helper.php
|
||||
echo " Helper entfernt"
|
||||
fi
|
||||
|
||||
# 3. Plugin-Verzeichnis entfernen
|
||||
if [ -d "/usr/local/plugins/mua" ]; then
|
||||
rm -rf /usr/local/plugins/mua
|
||||
echo " Plugin-Verzeichnis entfernt"
|
||||
fi
|
||||
|
||||
echo "=== MUA entfernt ==="
|
||||
@@ -1,42 +0,0 @@
|
||||
#!/bin/bash
|
||||
# MUA - Mikes Unraid Agent
|
||||
# Update-Script
|
||||
# Wird vom Unraid-Plugin-Installer bei Updates aufgerufen.
|
||||
|
||||
set -e
|
||||
|
||||
PLUGIN_DIR="/usr/local/plugins/mua"
|
||||
SERVICE_FILE="$PLUGIN_DIR/scripts/mua.service"
|
||||
HELPER_SRC="$PLUGIN_DIR/scripts/unraid-docker-mcp-helper.php"
|
||||
HELPER_DST="/usr/local/bin/unraid-docker-mcp-helper.php"
|
||||
|
||||
echo "=== MUA Update ==="
|
||||
|
||||
# 1. PHP-Helper aktualisieren
|
||||
if [ -f "$HELPER_SRC" ]; then
|
||||
cp "$HELPER_SRC" "$HELPER_DST"
|
||||
chmod 755 "$HELPER_DST"
|
||||
echo " Helper aktualisiert"
|
||||
fi
|
||||
|
||||
# 2. systemd-Service aktualisieren
|
||||
if [ -f "$SERVICE_FILE" ]; then
|
||||
cp "$SERVICE_FILE" /etc/systemd/system/mua.service
|
||||
chmod 644 /etc/systemd/system/mua.service
|
||||
systemctl daemon-reload
|
||||
echo " Service aktualisiert"
|
||||
fi
|
||||
|
||||
# 3. Service neu starten
|
||||
systemctl restart mua.service
|
||||
|
||||
# 4. Health-Check
|
||||
sleep 2
|
||||
if curl -sf "http://127.0.0.1:3002/health" > /dev/null 2>&1; then
|
||||
echo " Health-Check: OK"
|
||||
echo "=== MUA aktualisiert ==="
|
||||
else
|
||||
echo " WARNUNG: Health-Check fehlgeschlagen"
|
||||
systemctl status mua.service --no-pager || true
|
||||
exit 1
|
||||
fi
|
||||
Reference in New Issue
Block a user