Gemini MCP Tool

Instructions

Implementation Reference

• src/tools/brainstorm.tool.ts:137-170 (handler)

  The main handler function for the 'brainstorm' tool. It processes arguments, builds an enhanced prompt using helper functions, logs debug info, reports progress, and executes the Gemini CLI.

  execute: async (args, onProgress) => {
    const {
      prompt,
      model,
      methodology = 'auto',
      domain,
      constraints,
      existingContext,
      ideaCount = 12,
      includeAnalysis = true
    } = args;
  
    if (!prompt?.trim()) {
      throw new Error("You must provide a valid brainstorming challenge or question to explore");
    }
  
    let enhancedPrompt = buildBrainstormPrompt({
      prompt: prompt.trim() as string,
      methodology: methodology as string,
      domain: domain as string | undefined,
      constraints: constraints as string | undefined,
      existingContext: existingContext as string | undefined,
      ideaCount: ideaCount as number,
      includeAnalysis: includeAnalysis as boolean
    });
  
    Logger.debug(`Brainstorm: Using methodology '${methodology}' for domain '${domain || 'general'}'`);
    
    // Report progress to user
    onProgress?.(`Generating ${ideaCount} ideas via ${methodology} methodology...`);
    
    // Execute with Gemini
    return await executeGeminiCLI(enhancedPrompt, model as string | undefined, false, false, onProgress);
  }

• src/tools/brainstorm.tool.ts:118-127 (schema)

  Zod schema defining the input parameters and validation for the brainstorm tool.

  const brainstormArgsSchema = z.object({
    prompt: z.string().min(1).describe("Primary brainstorming challenge or question to explore"),
    model: z.string().optional().describe("Optional model to use (e.g., 'gemini-2.5-flash'). If not specified, uses the default model (gemini-2.5-pro)."),
    methodology: z.enum(['divergent', 'convergent', 'scamper', 'design-thinking', 'lateral', 'auto']).default('auto').describe("Brainstorming framework: 'divergent' (generate many ideas), 'convergent' (refine existing), 'scamper' (systematic triggers), 'design-thinking' (human-centered), 'lateral' (unexpected connections), 'auto' (AI selects best)"),
    domain: z.string().optional().describe("Domain context for specialized brainstorming (e.g., 'software', 'business', 'creative', 'research', 'product', 'marketing')"),
    constraints: z.string().optional().describe("Known limitations, requirements, or boundaries (budget, time, technical, legal, etc.)"),
    existingContext: z.string().optional().describe("Background information, previous attempts, or current state to build upon"),
    ideaCount: z.number().int().positive().default(12).describe("Target number of ideas to generate (default: 10-15)"),
    includeAnalysis: z.boolean().default(true).describe("Include feasibility, impact, and implementation analysis for generated ideas"),
  });

• src/tools/index.ts:9-16 (registration)

  The brainstormTool is registered by being pushed into the toolRegistry array alongside other tools.

  toolRegistry.push(
    askGeminiTool,
    pingTool,
    helpTool,
    brainstormTool,
    fetchChunkTool,
    timeoutTestTool
  );

• src/tools/brainstorm.tool.ts:6-64 (helper)

  Key helper function that constructs the detailed, structured prompt for the brainstorming session using the provided configuration and methodology-specific instructions.

  function buildBrainstormPrompt(config: {
    prompt: string;
    methodology: string;
    domain?: string;
    constraints?: string;
    existingContext?: string;
    ideaCount: number;
    includeAnalysis: boolean;
  }): string {
    const { prompt, methodology, domain, constraints, existingContext, ideaCount, includeAnalysis } = config;
    
    // Select methodology framework
    let frameworkInstructions = getMethodologyInstructions(methodology, domain);
    
    let enhancedPrompt = `# BRAINSTORMING SESSION
  
  ## Core Challenge
  ${prompt}
  
  ## Methodology Framework
  ${frameworkInstructions}
  
  ## Context Engineering
  *Use the following context to inform your reasoning:*
  ${domain ? `**Domain Focus:** ${domain} - Apply domain-specific knowledge, terminology, and best practices.` : ''}
  ${constraints ? `**Constraints & Boundaries:** ${constraints}` : ''}
  ${existingContext ? `**Background Context:** ${existingContext}` : ''}
  
  ## Output Requirements
  - Generate ${ideaCount} distinct, creative ideas
  - Each idea should be unique and non-obvious
  - Focus on actionable, implementable concepts
  - Use clear, descriptive naming
  - Provide brief explanations for each idea
  
  ${includeAnalysis ? `
  ## Analysis Framework
  For each idea, provide:
  - **Feasibility:** Implementation difficulty (1-5 scale)
  - **Impact:** Potential value/benefit (1-5 scale)
  - **Innovation:** Uniqueness/creativity (1-5 scale)
  - **Quick Assessment:** One-sentence evaluation
  ` : ''}
  
  ## Format
  Present ideas in a structured format:
  
  ### Idea [N]: [Creative Name]
  **Description:** [2-3 sentence explanation]
  ${includeAnalysis ? '**Feasibility:** [1-5] | **Impact:** [1-5] | **Innovation:** [1-5]\n**Assessment:** [Brief evaluation]' : ''}
  
  ---
  
  **Before finalizing, review the list: remove near-duplicates and ensure each idea satisfies the constraints.**
  
  Begin brainstorming session:`;
  
    return enhancedPrompt;
  }