From 2744cc5478fc4947da755abacfaa400d90ba4438 Mon Sep 17 00:00:00 2001 From: Mikei386 <44135113+Mikei386@users.noreply.github.com> Date: Wed, 26 Aug 2026 00:15:03 +0200 Subject: [PATCH] docs: prefer direct HTTP for MUA clients --- README.md | 44 ++++++++++++++++---------------------------- 1 file changed, 16 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index b946b4d..a0f0576 100644 --- a/README.md +++ b/README.md @@ -122,43 +122,31 @@ URL: http://192.168.1.2:3002/mcp Auth: Authorization: Bearer ``` -> **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: - connect_timeout: 30.0 + unraid: + url: http://192.168.1.2:3002/mcp + headers: + Authorization: Bearer + 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)