@superpms/jarvis-remote-hand-mcp

Servicio MCP que permite a un agente de IA controlar de forma remota varios ordenadores de tu cuenta para ejecutar comandos del sistema. Un uso típico es diagnosticar y reparar simultáneamente problemas de red u otros problemas del sistema en varias máquinas.

Este servicio no inicia sesión por sí mismo: reutiliza la sesión ya iniciada en el escritorio del «Asistente de control remoto»: agente → este servicio → escritorio → MQTT → dispositivo de destino.

Requisitos previos

1. Una máquina ejecuta el escritorio del «Asistente de control remoto» y ha iniciado sesión

2. El dispositivo de destino también ejecuta el escritorio, ha iniciado sesión con la misma cuenta y está en línea

3. Node.js >= 20.19

Related MCP server: mcp-windows-server

Configuración

Añade lo siguiente a la configuración de tu cliente MCP:

{
  "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 服务配置」页复制"
      }
    }
  }
}

Variables de entorno

Sobre el token de acceso

La interfaz puente equivale a un proxy de shell del dispositivo con sesión iniciada y escucha en la red local para permitir su uso entre máquinas, por lo que el servidor valida el token de forma obligatoria. El token se guarda en el directorio de datos de la aplicación del escritorio y no cambia al reiniciar; para invalidar un token antiguo, pulsa «Restablecer» en la página «Configuración del servicio MCP» y, a partir de entonces, habrá que actualizar la configuración de todos los agentes con el nuevo valor.

health es la única interfaz que no valida el token: existe precisamente para poder responder «¿está el puente en marcha?» incluso cuando el token aún no se ha emparejado, por lo que solo devuelve un {"ok":true} fijo, sin ninguna otra información.

Para el acceso entre máquinas también es necesario que el cortafuegos de la máquina de destino permita el puerto 47890.

Herramientas

El parámetro tool de send_command se elige según la plataforma del dispositivo de destino: bash (macOS/Linux), cmd o pws (Windows).

Flujo de uso

1. list_devices para obtener el device_uuid de un dispositivo en línea

2. send_command para enviar el comando y obtener el mid

3. query_mid para sondear hasta que el state sea «Completado» y leer el result

El state pasa sucesivamente por Enviando → En cola → En ejecución → Completado. El dispositivo controlado ejecuta los comandos uno a uno en el orden de recepción; solo se ejecuta uno a la vez.

La ejecución de comandos no tiene tiempo de espera: de unos minutos a más de diez es normal (p. ej. restablecimiento de red, instalaciones por lotes). Si al sondear ves «En ejecución», espera unos segundos y continúa; no lo des por fallido ni vuelvas a enviarlo.

Si el dispositivo está fuera de línea o no pertenece a la cuenta actual, send_command devuelve un error explicando el motivo; no devuelve un mid que nunca tendrá resultado.

Notas de seguridad

Las solicitudes que reenvía este servicio pueden ejecutar comandos arbitrarios del sistema en los dispositivos donde has iniciado sesión. Úsalo únicamente en redes de confianza; no expongas el puerto 47890 a Internet ni publiques el token de acceso en lugares públicos.

License

MIT