@superpms/jarvis-remote-hand-mcp

MCP-сервис, позволяющий AI-агенту удалённо управлять несколькими компьютерами, зарегистрированными на вас, и выполнять системные команды. Типичное применение — одновременная диагностика и устранение сетевых и других системных проблем на нескольких машинах.

Этот сервис не выполняет вход самостоятельно — он использует уже существующую сессию входа настольного приложения «Помощник удалённого управления»: агент → этот сервис → настольное приложение → MQTT → целевое устройство.

Предварительные требования

1. На одной машине запущено настольное приложение «Помощник удалённого управления» и выполнен вход

2. Целевое устройство также запускает настольное приложение, выполняет вход под той же учётной записью и находится в сети

3. Node.js >= 20.19

Related MCP server: mcp-windows-server

Конфигурация

Добавьте в конфигурацию вашего 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 服务配置」页复制"
      }
    }
  }
}

Переменные окружения

О токене доступа

Мостовой интерфейс эквивалентен shell-прокси для вошедшего в систему устройства и прослушивает локальную сеть для использования с других машин, поэтому сервер принудительно проверяет токен. Токен хранится в каталоге данных приложения настольного клиента и не меняется при перезапуске; чтобы аннулировать старый токен, нажмите «Сбросить» на странице «Конфигурация MCP-сервиса», после чего все конфигурации агентов нужно обновить на новое значение.

health — единственный интерфейс, не проверяющий токен: его смысл в том, чтобы отвечать «работает ли мост вообще», даже когда токен ещё не сопоставлен, поэтому он возвращает только фиксированный {"ok":true} без какой-либо другой информации.

Для доступа с других машин также необходимо разрешить порт 47890 в брандмауэре целевой машины.

Инструменты

Параметр tool в send_command выбирается по платформе целевого устройства: bash (macOS/Linux), cmd или pws (Windows).

Порядок использования

1. list_devices — получить device_uuid онлайн-устройства

2. send_command — отправить команду и получить mid

3. query_mid — опрашивать, пока state не станет «Завершено», затем прочитать result

state последовательно проходит через 发送中 → 排队中 → 运行中 → 已完成. Управляемое устройство выполняет команды по одной в порядке получения; в каждый момент выполняется только одна.

Для выполнения команд не задаётся тайм-аут — от нескольких минут до десяти и более минут это нормально (например, сброс сети, массовая установка). Если при опросе статус «Выполняется», продолжайте с интервалом в несколько секунд, не считайте это ошибкой и не отправляйте команду повторно.

Если устройство офлайн или не принадлежит текущей учётной записи, send_command сразу вернёт ошибку с объяснением причины и не вернёт mid, у которого никогда не будет результата.

Примечания по безопасности

Запросы, передаваемые этим сервисом, могут выполнять произвольные системные команды на устройстве, где вы выполнили вход. Используйте его только в доверенной сети, не открывайте порт 47890 в публичный интернет и не публикуйте токен доступа в открытых местах.

License

MIT