README: MCP-Client-Sektion generisch (client-agnostic), Hermes nur Beispiel

This commit is contained in:
Mikei386 committed 2026-08-18 13:03:06 +02:00
1 parent 43f94bcd19
commit c8c767d45b
1 file changed
+23 -5
+23 -5
View File
@@ -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 <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.
### 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)