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>
|
Auth: Authorization: Bearer <dein-api-key>
|
||||||
```
|
```
|
||||||
|
|
||||||
> **Unterschied zu den anderen MCP-Servern:** Die übrigen Tools
|
MUA läuft direkt auf Unraid und spricht **Streamable HTTP**. Ein SSH-Wrapper
|
||||||
> (Web-Suche, Home Assistant, Unraid, Sonarr/Radarr) laufen auf
|
ist weder erforderlich noch empfohlen. Dadurch bleiben Verbindungen kompakt
|
||||||
> **192.168.1.196** und werden per **SSH-stdio** angebunden. MUA läuft
|
und routinemäßige Tool-Aufrufe erzeugen keine SSH-Anmeldungen im Unraid-Syslog.
|
||||||
> direkt auf Unraid und spricht **HTTP** — kein SSH-Wrapper nötig.
|
|
||||||
|
|
||||||
### Beispiel: Hermes Agent
|
### Beispiel: Hermes Agent
|
||||||
|
|
||||||
Hermes kann MCP-Server per stdio (Wrapper) oder direkt per HTTP anbinden.
|
Hermes bindet MUA direkt per HTTP an. Wenn MCPHub eingesetzt wird, zeigt Hermes
|
||||||
Da MUA HTTP spricht, reicht ein HTTP-Client-Wrapper, der die stdio-Requests
|
stattdessen auf die vom Hub veröffentlichte Route; MCPHub verbindet sich dann
|
||||||
an `http://192.168.1.2:3002/mcp` mit dem Bearer-Token weiterleitet:
|
direkt mit diesem MUA-Endpunkt.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# ~/.hermes/config.yaml
|
# Direkte Anbindung ohne MCPHub
|
||||||
mcp_servers:
|
mcp_servers:
|
||||||
mua:
|
unraid:
|
||||||
command: /usr/bin/ssh
|
url: http://192.168.1.2:3002/mcp
|
||||||
args:
|
headers:
|
||||||
- -T
|
Authorization: Bearer <dein-api-key>
|
||||||
- -o
|
timeout: 300
|
||||||
- BatchMode=yes
|
connect_timeout: 30
|
||||||
- -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
|
|
||||||
enabled: true
|
enabled: true
|
||||||
```
|
```
|
||||||
|
|
||||||
> **Hinweis:** Der Wrapper `mua_mcp_http.py` (auf 196) übersetzt
|
Bei einer zentralen MCPHub-Installation wird dieselbe URL einmalig im Hub
|
||||||
> stdio → HTTP mit Bearer-Token. Alternativ: jeder MCP-Client, der
|
registriert. Alle Clients verwenden anschließend die Hub-Route und benötigen
|
||||||
> Streamable HTTP nativ unterstützt, kann MUA direkt anbinden.
|
keine eigene SSH- oder MUA-Konfiguration.
|
||||||
|
|
||||||
### Beispiel: Direkter HTTP-Test (curl)
|
### Beispiel: Direkter HTTP-Test (curl)
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user