docs: prefer direct HTTP for MUA clients

This commit is contained in:
Mikei386 committed 2026-08-26 00:15:03 +02:00
1 parent 8977ced7cf
commit 2744cc5478
1 file changed
+16 -28
+16 -28
View File
@@ -122,43 +122,31 @@ URL: http://192.168.1.2:3002/mcp
Auth: Authorization: Bearer <dein-api-key> Auth: Authorization: Bearer <dein-api-key>
``` ```
> **Unterschied zu den anderen MCP-Servern:** Die übrigen Tools MUA läuft direkt auf Unraid und spricht **Streamable HTTP**. Ein SSH-Wrapper
> (Web-Suche, Home Assistant, Unraid, Sonarr/Radarr) laufen auf ist weder erforderlich noch empfohlen. Dadurch bleiben Verbindungen kompakt
> **192.168.1.196** und werden per **SSH-stdio** angebunden. MUA läuft und routinemäßige Tool-Aufrufe erzeugen keine SSH-Anmeldungen im Unraid-Syslog.
> direkt auf Unraid und spricht **HTTP** — kein SSH-Wrapper nötig.
### Beispiel: Hermes Agent ### Beispiel: Hermes Agent
Hermes kann MCP-Server per stdio (Wrapper) oder direkt per HTTP anbinden. Hermes bindet MUA direkt per HTTP an. Wenn MCPHub eingesetzt wird, zeigt Hermes
Da MUA HTTP spricht, reicht ein HTTP-Client-Wrapper, der die stdio-Requests stattdessen auf die vom Hub veröffentlichte Route; MCPHub verbindet sich dann
an `http://192.168.1.2:3002/mcp` mit dem Bearer-Token weiterleitet: direkt mit diesem MUA-Endpunkt.
```yaml ```yaml
# ~/.hermes/config.yaml # Direkte Anbindung ohne MCPHub
mcp_servers: mcp_servers:
mua: unraid:
command: /usr/bin/ssh url: http://192.168.1.2:3002/mcp
args: headers:
- -T Authorization: Bearer <dein-api-key>
- -o timeout: 300
- BatchMode=yes connect_timeout: 30
- -o
- IdentitiesOnly=yes
- -i
- /Users/mike_i386/.ssh/lmstudio_unraid
- root@192.168.1.196
- /usr/bin/python3
- /opt/mike-ai/mua/mua_mcp_http.py
env:
MUA_URL: http://192.168.1.2:3002/mcp
MUA_API_KEY: <dein-api-key>
connect_timeout: 30.0
enabled: true enabled: true
``` ```
> **Hinweis:** Der Wrapper `mua_mcp_http.py` (auf 196) übersetzt Bei einer zentralen MCPHub-Installation wird dieselbe URL einmalig im Hub
> stdio → HTTP mit Bearer-Token. Alternativ: jeder MCP-Client, der registriert. Alle Clients verwenden anschließend die Hub-Route und benötigen
> Streamable HTTP nativ unterstützt, kann MUA direkt anbinden. keine eigene SSH- oder MUA-Konfiguration.
### Beispiel: Direkter HTTP-Test (curl) ### Beispiel: Direkter HTTP-Test (curl)