Gemini MCP Tool

Instructions

Implementation Reference

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

  The execute handler function that validates args, builds enhanced prompt using helpers, logs debug info, reports progress, and executes the prompt via 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 arguments for the brainstorm tool, including prompt, methodology, domain, and other options.
  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)

  Registration of the brainstormTool into the toolRegistry along with other tools.
  toolRegistry.push( askGeminiTool, pingTool, helpTool, brainstormTool, fetchChunkTool, timeoutTestTool );
• src/tools/brainstorm.tool.ts:6-64 (helper)

  Helper function that constructs the detailed brainstorming prompt including methodology instructions, context, and output format.
  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; }
• src/tools/brainstorm.tool.ts:66-116 (helper)

  Helper function providing methodology-specific instructions for different brainstorming frameworks.
  /** * Returns methodology-specific instructions for structured brainstorming */ function getMethodologyInstructions(methodology: string, domain?: string): string { const methodologies: Record<string, string> = { 'divergent': `**Divergent Thinking Approach:** - Generate maximum quantity of ideas without self-censoring - Build on wild or seemingly impractical ideas - Combine unrelated concepts for unexpected solutions - Use "Yes, and..." thinking to expand each concept - Postpone evaluation until all ideas are generated`, 'convergent': `**Convergent Thinking Approach:** - Focus on refining and improving existing concepts - Synthesize related ideas into stronger solutions - Apply critical evaluation criteria - Prioritize based on feasibility and impact - Develop implementation pathways for top ideas`, 'scamper': `**SCAMPER Creative Triggers:** - **Substitute:** What can be substituted or replaced? - **Combine:** What can be combined or merged? - **Adapt:** What can be adapted from other domains? - **Modify:** What can be magnified, minimized, or altered? - **Put to other use:** How else can this be used? - **Eliminate:** What can be removed or simplified? - **Reverse:** What can be rearranged or reversed?`, 'design-thinking': `**Human-Centered Design Thinking:** - **Empathize:** Consider user needs, pain points, and contexts - **Define:** Frame problems from user perspective - **Ideate:** Generate user-focused solutions - **Consider Journey:** Think through complete user experience - **Prototype Mindset:** Focus on testable, iterative concepts`, 'lateral': `**Lateral Thinking Approach:** - Make unexpected connections between unrelated fields - Challenge fundamental assumptions - Use random word association to trigger new directions - Apply metaphors and analogies from other domains - Reverse conventional thinking patterns`, 'auto': `**AI-Optimized Approach:** ${domain ? `Given the ${domain} domain, I'll apply the most effective combination of:` : 'I\'ll intelligently combine multiple methodologies:'} - Divergent exploration with domain-specific knowledge - SCAMPER triggers and lateral thinking - Human-centered perspective for practical value` }; return methodologies[methodology] || methodologies['auto']; }