N Lobby MCP Server

Instructions

Implementation Reference

• src/server.ts:1033-1070 (handler)

  The main execution logic for the 'login_help' tool. Parses optional email argument, validates it using CredentialManager, constructs a comprehensive help message with user-type specific guidance, troubleshooting tips, and session statistics, then returns it as text content.

  case "login_help": {
    const { email } = args as { email?: string };
  
    let helpMessage = `[LOGIN] N Lobby Login Help\n\n`;
  
    if (email) {
      const emailValidation =
        this.credentialManager.validateEmail(email);
      helpMessage += `[EMAIL] Email: ${email}\n`;
      helpMessage += `[USER] User Type: ${emailValidation.userType}\n`;
      helpMessage += `[SUCCESS] Valid: ${emailValidation.valid ? "Yes" : "No"}\n\n`;
  
      if (!emailValidation.valid) {
        helpMessage += `[ERROR] Issue: ${emailValidation.message}\n\n`;
      }
  
      helpMessage += this.credentialManager.getLoginGuidance(
        emailValidation.userType,
      );
    } else {
      helpMessage += this.credentialManager.getLoginGuidance("unknown");
    }
  
    helpMessage += `\n\n${this.credentialManager.getTroubleshootingTips()}`;
  
    // Add session stats
    const stats = this.credentialManager.getSessionStats();
    helpMessage += `\n\n[STATUS] Session Stats:\n- Active sessions: ${stats.total - stats.expired}\n- Expired sessions: ${stats.expired}`;
  
    return {
      content: [
        {
          type: "text",
          text: helpMessage,
        },
      ],
    };
  }

• src/server.ts:418-431 (registration)

  Registers the 'login_help' tool in the MCP server's tool list, including its name, description, and input schema defining an optional 'email' parameter.

  {
    name: "login_help",
    description: "Get help and troubleshooting tips for N Lobby login",
    inputSchema: {
      type: "object",
      properties: {
        email: {
          type: "string",
          description:
            "Your email address (optional, for personalized help)",
        },
      },
    },
  },

• src/server.ts:421-431 (schema)

  Defines the input schema for the 'login_help' tool, specifying an optional string 'email' parameter.

    inputSchema: {
      type: "object",
      properties: {
        email: {
          type: "string",
          description:
            "Your email address (optional, for personalized help)",
        },
      },
    },
  },

• src/credential-manager.ts:24-56 (helper)

  Helper method called by login_help handler to validate the provided email and determine user type (student, staff, parent, or unknown) based on domain.

  validateEmail(email: string): {
    valid: boolean;
    userType: "student" | "staff" | "parent" | "unknown";
    message?: string;
  } {
    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
  
    if (!emailRegex.test(email)) {
      return {
        valid: false,
        userType: "unknown",
        message: "Invalid email format",
      };
    }
  
    const domain = email.split("@")[1].toLowerCase();
  
    // N High School Group domains
    if (domain === "nnn.ed.jp") {
      return { valid: true, userType: "student" };
    } else if (domain === "nnn.ac.jp") {
      return { valid: true, userType: "staff" };
    } else if (
      domain === "gmail.com" ||
      domain === "yahoo.com" ||
      domain === "outlook.com" ||
      domain === "hotmail.com"
    ) {
      return { valid: true, userType: "parent" };
    } else {
      return { valid: true, userType: "parent" }; // Allow other domains for parents
    }
  }

• src/credential-manager.ts:106-142 (helper)

  Helper method providing user-type specific login instructions, used by the login_help handler to generate personalized guidance.

    getLoginGuidance(
      userType: "student" | "staff" | "parent" | "unknown",
    ): string {
      switch (userType) {
        case "student":
          return `
  [STUDENT] Student Login Guide:
  - Use your @nnn.ed.jp email address
  - Use your N High School password
  - If you have 2FA enabled, you'll need to complete it during login
  - Contact your homeroom teacher if you've forgotten your password`;
  
        case "staff":
          return `
  [STAFF] Staff Login Guide:
  - Use your @nnn.ac.jp email address
  - Use your N High School staff password
  - If you have 2FA enabled, you'll need to complete it during login
  - Contact IT support if you're having trouble accessing your account`;
  
        case "parent":
          return `
  [PARENT] Parent Login Guide:
  - Use the email address registered with your child's school account
  - Use the password you set when creating your parent account
  - If you haven't created a parent account yet, contact your child's school
  - If you've forgotten your password, use the password reset option`;
  
        default:
          return `
  [LOGIN] General Login Guide:
  - Use your registered email address
  - Use your N Lobby password
  - If you have 2FA enabled, you'll need to complete it during login
  - Contact support if you're having trouble`;
      }
    }