README: MCP-Client-Sektion generisch (client-agnostic), Hermes nur Beispiel
This commit is contained in:
@@ -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)
|
||||||
|
|||||||
Reference in New Issue
Block a user