hotlogin-mcp

Servidor MCP (stdio) para la API local de HotLogin. Paquete npm: hotlogin-local-api-mcp.

Para usarlo con las habilidades (Skills) dentro del repositorio, consulte skills/xbrowser-automation/.

MCP

Cursor

Settings → MCP → Add new MCP server, ejemplo:

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

Si no hay autenticación, puede omitir env o dejar solo PORT.

npx (mínimo)

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

Desarrollo local (este repositorio)

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"
      }
    }
  }
}

En Windows, si npx no se inicia, puede cambiarlo a "command": "cmd", "args": ["/c", "npx", "-y", "hotlogin-local-api-mcp"].

Related MCP server: scout-mcp-server

Variables de entorno

Coinciden con src/api/config.ts:

Requisitos previos

• El cliente de HotLogin debe estar iniciado y la API local debe ser accesible.

• Node.js ≥ 18

Herramientas

Lista de registro: src/mcp/tools.ts, validación de parámetros: src/mcp/schemas.ts.

Flujo típico: env_create → env_launch (obtener wsEndpoint) → session_attach → page_visit / element_* → env_terminate.

Solución de problemas

• Fallo en health_check: Verifique que PORT / BASE_URL / API_KEY coincidan con el servicio local.

• Fallo o tiempo de espera en session_attach: Si wsEndpoint ha caducado, vuelva a ejecutar env_launch; verifique la red/firewall de su equipo.

Licencia

MIT