hotlogin-mcp

HotLogin Local API용 MCP 서버(stdio)입니다. npm 패키지: hotlogin-local-api-mcp.

저장소 내 Skill과 함께 사용할 경우 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 클라이언트가 실행 중이며 Local 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를 다시 수행하세요. 로컬 네트워크/방화벽을 확인하세요.

License

MIT