diff --git a/README.md b/README.md index e304acb..541ef00 100644 --- a/README.md +++ b/README.md @@ -90,11 +90,28 @@ Der Key wird in `/boot/config/plugins/mua/mua.conf` gespeichert (chmod 600). ## MCP-Client konfigurieren -### Hermes Agent +MUA ist ein **Standard-MCP-Server** (Streamable HTTP, POST-only, JSON-RPC 2.0). +Jeder MCP-Client kann es nutzen — URL + Bearer-Token reichen: -In `~/.hermes/config.yaml` unter `mcp_servers`: +``` +URL: http://192.168.1.2:3002/mcp +Auth: Authorization: Bearer +``` + +> **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. + +### 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: ```yaml +# ~/.hermes/config.yaml +mcp_servers: mua: command: /usr/bin/ssh args: @@ -115,10 +132,11 @@ In `~/.hermes/config.yaml` unter `mcp_servers`: enabled: true ``` -> **Hinweis:** Hermes nutzt SSH-stdio (Python-Wrapper auf 196), nicht direkt -> HTTP. Der Wrapper `mua_mcp_http.py` übersetzt stdio → HTTP mit Bearer-Token. +> **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. -### Direkter HTTP-Test (curl) +### Beispiel: Direkter HTTP-Test (curl) ```bash # Health-Check (ohne Auth)