docs: prefer direct HTTP for MUA clients
This commit is contained in:
1 parent
8977ced7cf
commit
2744cc5478
1 file changed
+16
-28
@@ -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)
|
||||
|
||||
|
||||
Reference in new issue
Block a user