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