@superpms/jarvis-remote-hand-mcp

Ein MCP-Dienst, der es KI-Agenten ermöglicht, Systembefehle auf mehreren Computern in Ihrem Besitz remote auszuführen. Typischer Anwendungsfall ist die gleichzeitige Diagnose und Behebung von Systemproblemen wie Netzwerkproblemen auf mehreren Maschinen.

Dieser Dienst meldet sich nicht selbst an, sondern nutzt die bereits vorhandene Anmeldung des Desktop-Clients „远程控制助手": Agent → dieser Dienst → Desktop-Client → MQTT → Zielgerät.

Voraussetzungen

1. Auf einem Rechner läuft der Desktop-Client „远程控制助手" und ist angemeldet

2. Das Zielgerät führt ebenfalls den Desktop-Client aus, ist mit demselben Konto angemeldet und online

3. Node.js >= 20.19

Related MCP server: rustdesk-mcp-bridge

Konfiguration

Fügen Sie Folgendes zu Ihrer MCP-Client-Konfiguration hinzu:

{
  "mcpServers": {
    "jarvis-remote-hand": {
      "command": "npx",
      "args": ["-y", "@superpms/jarvis-remote-hand-mcp"],
      "env": {
        "ARH_BRIDGE_URL": "http://127.0.0.1:47890",
        "ARH_BRIDGE_TOKEN": "在桌面端「MCP 服务配置」页复制"
      }
    }
  }
}

Umgebungsvariablen

Zum Zugriffstoken

Die Bridge-Schnittstelle entspricht einem Shell-Proxy des angemeldeten Geräts und lauscht im LAN für die geräteübergreifende Nutzung, daher erzwingt der Server die Token-Validierung. Das Token wird im Anwendungsdatenverzeichnis des Desktop-Clients gespeichert und bleibt über Neustarts hinweg unverändert. Um ein altes Token zu widerrufen, klicken Sie auf der Seite „MCP-Dienstkonfiguration" auf „Zurücksetzen"; danach müssen alle Agent-Konfigurationen auf den neuen Wert geändert werden.

health ist die einzige Schnittstelle, die das Token nicht validiert – ihr Zweck ist es, auch dann antworten zu können, ob die Bridge läuft, wenn das Token noch nicht abgeglichen ist. Daher gibt sie nur ein festes {"ok":true} zurück, ohne weitere Informationen.

Für den geräteübergreifenden Zugriff muss die Firewall des Zielrechners außerdem den Port 47890 freigeben.

Werkzeuge

Der Parameter tool von send_command wird je nach Plattform des Zielgeräts gewählt: bash (macOS/Linux), cmd oder pws (Windows).

Verwendungsablauf

1. list_devices abrufen, um die device_uuid des Online-Geräts zu erhalten

2. send_command senden, um mid zu erhalten

3. query_mid abfragen, bis state „已完成" ist, dann result lesen

state durchläuft nacheinander 发送中 → 排队中 → 运行中 → 已完成. Das gesteuerte Gerät führt die Befehle in der Reihenfolge des Empfangs aus, jeweils nur einen zur gleichen Zeit.

Für die Befehlsausführung gibt es kein Timeout – einige Minuten bis zu zehn oder mehr Minuten sind normal (z. B. bei Netzwerk-Reset oder Masseninstallation). Wenn Sie beim Abfragen den Status „运行中" sehen, warten Sie einige Sekunden und fahren Sie fort; bewerten Sie es nicht als Fehler und senden Sie nicht erneut.

Wenn das Gerät offline ist oder nicht zum aktuellen Konto gehört, meldet send_command direkt einen Fehler mit Angabe des Grunds und gibt kein mid zurück, das nie ein Ergebnis liefert.

Sicherheitshinweise

Über diesen Dienst weitergeleitete Anfragen können beliebige Systembefehle auf Ihrem angemeldeten Gerät ausführen. Verwenden Sie ihn nur in vertrauenswürdigen Netzwerken, setzen Sie den Port 47890 nicht dem öffentlichen Internet aus und veröffentlichen Sie das Zugriffstoken nicht an öffentlichen Orten.

Lizenz

MIT