hotlogin-mcp

MCP-сервер (stdio) для локального API HotLogin. npm-пакет: hotlogin-local-api-mcp.

При использовании со скриптами (Skills) из репозитория см. skills/xbrowser-automation/.

MCP

Cursor

Settings → MCP → Add new MCP server, пример:

{
  "mcpServers": {
    "hotlogin-local-api": {
      "command": "npx",
      "args": ["-y", "hotlogin-local-api-mcp"],
      "env": {
        "PORT": "60000",
        "API_KEY": "your_api_key"
      }
    }
  }
}

Если аутентификация не требуется, можно убрать env или оставить только PORT.

npx (минимальный вариант)

{
  "mcpServers": {
    "hotlogin-local-api": {
      "command": "npx",
      "args": ["-y", "hotlogin-local-api-mcp"]
    }
  }
}

Локальная разработка (этот репозиторий)

npm install && npm run build

{
  "mcpServers": {
    "hotlogin-local-api": {
      "command": "node",
      "args": ["/你的路径/hotlogin-mcp/build/server.core.js"],
      "env": {
        "PORT": "60000",
        "API_KEY": "your_api_key"
      }
    }
  }
}

Если в Windows npx не запускается, можно изменить на "command": "cmd", "args": ["/c", "npx", "-y", "hotlogin-local-api-mcp"].

Related MCP server: scout-mcp-server

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

Соответствуют src/api/config.ts:

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

• Клиент HotLogin запущен, локальный API доступен

• Node.js ≥ 18

Инструменты

Список зарегистрированных инструментов: src/mcp/tools.ts, проверка параметров: src/mcp/schemas.ts.

Типовой процесс: env_create → env_launch (получение wsEndpoint) → session_attach → page_visit / element_* → env_terminate.

Устранение неполадок

• Ошибка health_check: проверьте, что PORT / BASE_URL / API_KEY совпадают с настройками локальной службы.

• Ошибка или тайм-аут session_attach: если wsEndpoint устарел, выполните env_launch повторно; проверьте настройки сети/брандмауэра на локальном компьютере.

Лицензия

MIT