N Lobby MCP Server

Instructions

Implementation Reference

• src/server.ts:996-1031 (handler)

  MCP tool handler for 'interactive_login': initializes browser, performs interactive login via browserAuth, sets cookies, and returns success/error response
  case "interactive_login": try { // Initialize browser await this.browserAuth.initializeBrowser(); // Start interactive login const extractedCookies = await this.browserAuth.interactiveLogin(); // Set cookies in API client this.api.setCookies(extractedCookies.allCookies); // Close browser await this.browserAuth.close(); return { content: [ { type: "text", text: `[SUCCESS] Successfully logged in to N Lobby!\n\nExtracted cookies:\n- Session Token: ${extractedCookies.sessionToken ? "present" : "missing"}\n- CSRF Token: ${extractedCookies.csrfToken ? "present" : "missing"}\n- Callback URL: ${extractedCookies.callbackUrl || "not set"}\n\nYou can now access real N Lobby data using other tools.`, }, ], }; } catch (error) { // Ensure browser is closed on error await this.browserAuth.close(); return { content: [ { type: "text", text: `[ERROR] Interactive login failed: ${error instanceof Error ? error.message : "Unknown error"}\n\nPlease try again or contact support if the issue persists.`, }, ], }; }
• src/server.ts:413-416 (schema)

  Input schema for interactive_login tool (empty object, no parameters required)
  inputSchema: { type: "object", properties: {}, },
• src/server.ts:409-417 (registration)

  Registration of the 'interactive_login' tool in the MCP tools list
  { name: "interactive_login", description: "Open browser for manual login to N Lobby (no credentials required)", inputSchema: { type: "object", properties: {}, }, },
• src/browser-auth.ts:513-572 (helper)

  Core helper function implementing interactive browser-based login, navigating to N Lobby, waiting for user login, and extracting cookies
  async interactiveLogin(): Promise<ExtractedCookies> { // Check browser health before starting const isHealthy = await this.checkBrowserHealth(); if (!isHealthy) { logger.warn("Browser unhealthy, reinitializing..."); await this.initializeBrowser(); } if (!this.browser || !this.page) { throw new Error( "Browser not initialized. Call initializeBrowser() first.", ); } try { logger.info("Starting interactive login process..."); // Navigate to N Lobby await this.page.goto(CONFIG.nlobby.baseUrl, { waitUntil: "networkidle2", timeout: 30000, }); logger.info( "N Lobby page loaded. Please complete the login process in the browser window.", ); logger.info("The browser will remain open for you to login manually."); // Wait for user to complete login (detect when we're on the authenticated page) await this.waitForLoginCompletionWithRetry(300000); logger.info("Login detected! Extracting cookies..."); // Extract cookies after successful login const cookies = await this.extractCookies(); return cookies; } catch (error) { logger.error("Interactive login failed:", error); // Enhanced error logging for interactive login if (this.page) { try { const currentUrl = await this.page.url(); const title = await this.page.title(); logger.error(`Current URL: ${currentUrl}`); logger.error(`Page title: ${title}`); // Take screenshot for debugging await this.takeScreenshot("interactive-login-failure-debug.png"); } catch (debugError) { logger.error("Failed to capture debug information:", debugError); } } throw new Error( `Interactive login failed: ${error instanceof Error ? error.message : "Unknown error"}`, ); } }