DollhouseMCP

Instructions

Implementation Reference

• src/server/tools/AuthTools.ts:43-58 (registration)

  Tool registration with name, description, input schema, and handler that delegates to server.configureOAuth
  { tool: { name: "configure_oauth", description: "Configure GitHub OAuth client ID for authentication. If no client_id provided, shows current configuration status. If client_id provided, validates format and saves it to config. Use when users need to set up OAuth or check their configuration.", inputSchema: { type: "object", properties: { client_id: { type: "string", description: "GitHub OAuth client ID (starts with 'Ov23li' followed by at least 14 alphanumeric characters)" } } } }, handler: (args: { client_id?: string }) => server.configureOAuth(args.client_id) },
• src/config/ConfigManager.ts:517-538 (handler)

  Core logic for configuring (setting) the OAuth client ID, including validation and saving to config file
  public async setGitHubClientId(clientId: string): Promise<void> { if (!ConfigManager.validateClientId(clientId)) { throw new Error( `Invalid GitHub client ID format. Expected format: Ov23li followed by at least 14 alphanumeric characters (e.g., Ov23liABCDEFGHIJKLMN)` ); } if (!this.config) { this.config = this.getDefaultConfig(); } // Ensure github.auth object exists if (!this.config.github) { this.config.github = this.getDefaultConfig().github; } if (!this.config.github.auth) { this.config.github.auth = this.getDefaultConfig().github.auth; } this.config.github.auth.client_id = clientId; await this.saveConfig(); }
• src/config/ConfigManager.ts:503-512 (helper)

  Helper to retrieve current OAuth client ID (used when no client_id provided)
  public getGitHubClientId(): string | null { // Check environment variable first const envClientId = process.env.DOLLHOUSE_GITHUB_CLIENT_ID; if (envClientId) { return envClientId; } // Fall back to config file return this.config?.github?.auth?.client_id || null; }
• src/config/ConfigManager.ts:634-642 (helper)

  Validation helper for client ID format
  public static validateClientId(clientId: any): boolean { if (typeof clientId !== 'string' || !clientId) { return false; } // GitHub OAuth client IDs follow the pattern: Ov23li[A-Za-z0-9]{14,} const clientIdPattern = /^Ov23li[A-Za-z0-9]{14,}$/; return clientIdPattern.test(clientId); }
• src/server/types.ts:51-51 (schema)

  Type definition for the delegated server.configureOAuth method
  configureOAuth(client_id?: string): Promise<any>;