hotlogin-mcp

MCP-Server (stdio) für die HotLogin Local API. npm-Paket: hotlogin-local-api-mcp.

Zur Verwendung mit den Skills im Repository siehe skills/xbrowser-automation/.

MCP

Cursor

Settings → MCP → Add new MCP server, Beispiel:

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

Ohne Authentifizierung kann env weggelassen oder nur PORT beibehalten werden.

npx (minimal)

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

Lokale Entwicklung (dieses Repository)

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

Falls npx unter Windows nicht startet, kann dies zu "command": "cmd" und "args": ["/c", "npx", "-y", "hotlogin-local-api-mcp"] geändert werden.

Related MCP server: scout-mcp-server

Umgebungsvariablen

Identisch mit src/api/config.ts:

Voraussetzungen

• HotLogin-Client ist gestartet und die Local API ist erreichbar

• Node.js ≥ 18

Tools

Registrierungsliste: src/mcp/tools.ts, Parameterprüfung: src/mcp/schemas.ts.

Typischer Ablauf: env_create → env_launch (abrufen von wsEndpoint) → session_attach → page_visit / element_* → env_terminate.

Fehlerbehebung

• health_check fehlgeschlagen: Überprüfen Sie, ob PORT / BASE_URL / API_KEY mit dem lokalen Dienst übereinstimmen.

• session_attach fehlgeschlagen oder Zeitüberschreitung: Wenn wsEndpoint abgelaufen ist, führen Sie env_launch erneut aus; überprüfen Sie das lokale Netzwerk/die Firewall.

Lizenz

MIT