Refactor: Doku-konformes Plugin-Format (DOCTYPE Entities, Method=update, .page-WebUI)
This commit is contained in:
Mikei386
+95
-50
@@ -1,36 +1,39 @@
|
||||
<?xml version='1.0' standalone='yes'?>
|
||||
<!DOCTYPE PLUGIN>
|
||||
<!DOCTYPE PLUGIN [
|
||||
<!ENTITY name "mua">
|
||||
<!ENTITY author "Michael">
|
||||
<!ENTITY version "1.0.0">
|
||||
<!ENTITY launch "Settings/MUA">
|
||||
<!ENTITY pluginURL "http://192.168.1.2:4000/michael/MUA-Mikes-Unraid-Agent/raw/branch/main/plugin/mua.plg">
|
||||
<!ENTITY pluginLOC "/boot/config/plugins/&name;">
|
||||
<!ENTITY emhttpLOC "/usr/local/emhttp/plugins/&name;">
|
||||
]>
|
||||
|
||||
<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"
|
||||
<PLUGIN name="&name;"
|
||||
author="&author;"
|
||||
version="&version;"
|
||||
launch="&launch;"
|
||||
pluginURL="&pluginURL;"
|
||||
icon="cubes"
|
||||
min="7.0.0"
|
||||
support="http://192.168.1.2:4000/michael/MUA-Mikes-Unraid-Agent"
|
||||
project="http://192.168.1.2:4000/michael/MUA-Mikes-Unraid-Agent"
|
||||
>
|
||||
|
||||
<CHANGES>
|
||||
<![CDATA[
|
||||
###1.0.0###
|
||||
Initial release: 21 Docker, network, and system tools as MCP server over HTTP (Streamable HTTP, port 3002).
|
||||
]]>
|
||||
### 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.
|
||||
===========================================
|
||||
PRE-INSTALL: Cleanup + Verzeichnisse
|
||||
===========================================
|
||||
-->
|
||||
<FILE Run="/bin/bash">
|
||||
<INLINE>
|
||||
set -e
|
||||
|
||||
PLUGIN_DIR="/usr/local/emhttp/plugins/mua"
|
||||
CONFIG_DIR="/boot/config/plugins/mua"
|
||||
GIT_REPO="http://192.168.1.2:4000/michael/MUA-Mikes-Unraid-Agent.git"
|
||||
TMP_DIR="/tmp/mua-install-$$"
|
||||
|
||||
echo ""
|
||||
echo "===================================================="
|
||||
echo " MUA - Mikes Unraid Agent"
|
||||
@@ -38,60 +41,85 @@ echo " Installation"
|
||||
echo "===================================================="
|
||||
echo ""
|
||||
|
||||
# 1. Verzeichnisse
|
||||
mkdir -p "$PLUGIN_DIR/mcp"
|
||||
mkdir -p "$PLUGIN_DIR/scripts"
|
||||
mkdir -p "$CONFIG_DIR"
|
||||
# Verzeichnisse
|
||||
mkdir -p &emhttpLOC;/mcp
|
||||
mkdir -p &emhttpLOC;/scripts
|
||||
mkdir -p &pluginLOC;
|
||||
mkdir -p /var/log/plugins
|
||||
touch /var/log/plugins/mua.log
|
||||
|
||||
</INLINE>
|
||||
</FILE>
|
||||
|
||||
<!--
|
||||
===========================================
|
||||
GIT-CLONE + DATEIEN INSTALLIEREN
|
||||
===========================================
|
||||
-->
|
||||
<FILE Run="/bin/bash">
|
||||
<INLINE>
|
||||
set -e
|
||||
|
||||
GIT_REPO="http://192.168.1.2:4000/michael/MUA-Mikes-Unraid-Agent.git"
|
||||
TMP_DIR="/tmp/mua-install-$$"
|
||||
|
||||
# 2. Git-Repo klonen
|
||||
echo " Kloniere Repo..."
|
||||
git clone --depth 1 "$GIT_REPO" "$TMP_DIR" 2>&1 | sed 's/^/ /'
|
||||
|
||||
# 3. PHP-Dateien installieren
|
||||
# MCP-Server (PHP)
|
||||
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
|
||||
cp "$TMP_DIR/mcp/server.php" &emhttpLOC;/mcp/
|
||||
cp "$TMP_DIR/mcp/helpers.php" &emhttpLOC;/mcp/
|
||||
cp "$TMP_DIR/mcp/tools.php" &emhttpLOC;/mcp/
|
||||
cp "$TMP_DIR/mcp/selftest.php" &emhttpLOC;/mcp/
|
||||
chmod 644 &emhttpLOC;/mcp/*.php
|
||||
|
||||
# 4. PHP-Helper (Write-Operationen)
|
||||
# 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
|
||||
# WebGUI-Tab (.page-Format)
|
||||
echo " Installiere WebGUI-Tab..."
|
||||
cp "$TMP_DIR/scripts/plugin.php" "$PLUGIN_DIR/plugin.php"
|
||||
chmod 644 "$PLUGIN_DIR/plugin.php"
|
||||
cp "$TMP_DIR/scripts/mua.page" &emhttpLOC;/mua.page
|
||||
chmod 644 &emhttpLOC;/mua.page
|
||||
|
||||
# 6. SysVinit-Service
|
||||
# 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
|
||||
# Cleanup
|
||||
rm -rf "$TMP_DIR"
|
||||
|
||||
</INLINE>
|
||||
</FILE>
|
||||
|
||||
<!--
|
||||
===========================================
|
||||
POST-INSTALL: Selftest + Service starten
|
||||
===========================================
|
||||
-->
|
||||
<FILE Run="/bin/bash">
|
||||
<INLINE>
|
||||
set +e
|
||||
|
||||
# 8. Selftest
|
||||
echo " Führe Selftest aus..."
|
||||
php "$PLUGIN_DIR/mcp/selftest.php" 2>&1 | sed 's/^/ /'
|
||||
php &emhttpLOC;/mcp/selftest.php 2>&1 | sed 's/^/ /'
|
||||
|
||||
# 9. Service starten
|
||||
echo " Starte MCP-Server..."
|
||||
/etc/rc.d/rc.mua start
|
||||
|
||||
# 10. Health-Check
|
||||
# Health-Check
|
||||
sleep 2
|
||||
if curl -sf "http://127.0.0.1:3002/health" > /dev/null 2>&1; then
|
||||
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 " WebGUI: Settings > MUA"
|
||||
echo "===================================================="
|
||||
else
|
||||
echo ""
|
||||
@@ -100,14 +128,31 @@ else
|
||||
echo "===================================================="
|
||||
fi
|
||||
|
||||
# 11. Cleanup
|
||||
rm -rf "$TMP_DIR"
|
||||
exit 0
|
||||
|
||||
</INLINE>
|
||||
</FILE>
|
||||
|
||||
<!--
|
||||
Remove script.
|
||||
===========================================
|
||||
UPDATE: Alte Dateien bereinigen
|
||||
===========================================
|
||||
-->
|
||||
<FILE Run="/bin/bash" Method="update">
|
||||
<INLINE>
|
||||
# Alte Dateien entfernen vor Reinstall
|
||||
rm -rf &emhttpLOC;/mcp
|
||||
rm -rf &emhttpLOC;/scripts
|
||||
rm -f &emhttpLOC;/mua.page
|
||||
rm -f &emhttpLOC;/plugin.php
|
||||
|
||||
</INLINE>
|
||||
</FILE>
|
||||
|
||||
<!--
|
||||
===========================================
|
||||
REMOVE: Deinstallation
|
||||
===========================================
|
||||
-->
|
||||
<FILE Run="/bin/bash" Method="remove">
|
||||
<INLINE>
|
||||
@@ -128,10 +173,10 @@ rm -f /etc/rc.d/rc.mua
|
||||
rm -f /usr/local/bin/unraid-docker-mcp-helper.php
|
||||
|
||||
# 4. Plugin-Verzeichnis entfernen
|
||||
rm -rf /usr/local/emhttp/plugins/mua
|
||||
rm -rf &emhttpLOC;
|
||||
|
||||
# 5. Config entfernen
|
||||
rm -rf /boot/config/plugins/mua
|
||||
rm -rf &pluginLOC;
|
||||
|
||||
# 6. Logs entfernen
|
||||
rm -f /var/log/plugins/mua.log
|
||||
|
||||
@@ -1,9 +1,14 @@
|
||||
---
|
||||
Menu="OtherSettings"
|
||||
Type="xmenu"
|
||||
Title="MUA"
|
||||
Icon="cubes"
|
||||
---
|
||||
<?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.
|
||||
* WebGUI-Tab (mua.page)
|
||||
* Unraid-Standard .page-Format
|
||||
*/
|
||||
|
||||
$plugin_dir = '/usr/local/emhttp/plugins/mua';
|
||||
@@ -23,6 +28,7 @@ if (file_exists($pidfile)) {
|
||||
|
||||
// Health-Check
|
||||
$health = null;
|
||||
$health_code = 0;
|
||||
$ch = curl_init('http://127.0.0.1:' . $port . '/health');
|
||||
curl_setopt_array($ch, [
|
||||
CURLOPT_RETURNTRANSFER => true,
|
||||
@@ -34,53 +40,34 @@ $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; }
|
||||
.mua-status { padding: 12px 16px; border-radius: 6px; margin: 12px 0; font-size: 0.95em; }
|
||||
.mua-status.ok { background: #e8f5e9; border: 1px solid #4caf50; color: #2e7d32; }
|
||||
.mua-status.err { background: #ffebee; border: 1px solid #f44336; color: #c62828; }
|
||||
.mua-status.warn { background: #fff3e0; border: 1px solid #ff9800; color: #e65100; }
|
||||
.mua-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>
|
||||
<div class="mua-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>
|
||||
<div class="mua-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>
|
||||
<div class="mua-status ok">✅ Health-Check: OK</div>
|
||||
<?php elseif ($health !== false): ?>
|
||||
<div class="status warn">⚠️ Health-Check: HTTP <?= $health_code ?></div>
|
||||
<div class="mua-status warn">⚠️ Health-Check: HTTP <?= $health_code ?></div>
|
||||
<?php else: ?>
|
||||
<div class="status warn">⚠️ Health-Check: nicht erreichbar</div>
|
||||
<div class="mua-status warn">⚠️ Health-Check: nicht erreichbar</div>
|
||||
<?php endif; ?>
|
||||
|
||||
<h2>MCP-Endpunkt</h2>
|
||||
<p class="endpoint"><?= $endpoint ?></p>
|
||||
<p class="mua-endpoint"><?= $endpoint ?></p>
|
||||
<p>Transport: <code>Streamable HTTP</code> (POST-only) · JSON-RPC 2.0</p>
|
||||
|
||||
<h2>Details</h2>
|
||||
@@ -112,6 +99,3 @@ code { background: #f5f5f5; padding: 2px 6px; border-radius: 3px; font-size: 0.9
|
||||
<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>
|
||||
Reference in New Issue
Block a user