docs: prefer direct HTTP for MUA clients

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