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

This commit is contained in:
Mikei386
2026-08-18 13:03:06 +02:00
parent 43f94bcd19
commit c8c767d45b
+23 -5
View File
@@ -90,11 +90,28 @@ Der Key wird in `/boot/config/plugins/mua/mua.conf` gespeichert (chmod 600).
## MCP-Client konfigurieren ## 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 ```yaml
# ~/.hermes/config.yaml
mcp_servers:
mua: mua:
command: /usr/bin/ssh command: /usr/bin/ssh
args: args:
@@ -115,10 +132,11 @@ In `~/.hermes/config.yaml` unter `mcp_servers`:
enabled: true enabled: true
``` ```
> **Hinweis:** Hermes nutzt SSH-stdio (Python-Wrapper auf 196), nicht direkt > **Hinweis:** Der Wrapper `mua_mcp_http.py` (auf 196) übersetzt
> HTTP. Der Wrapper `mua_mcp_http.py` übersetzt stdio → HTTP mit Bearer-Token. > 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 ```bash
# Health-Check (ohne Auth) # Health-Check (ohne Auth)