stacksfinder-mcp

Instructions

Implementation Reference

• src/tools/recommend-demo.ts:162-242 (handler)

  The core handler function that executes the recommend_stack_demo tool logic. It handles input parsing, rate limiting with daily demo limit, selects the best technologies per category using weighted scoring based on project type and scale, formats a markdown table response, and promotes the pro version.
  export function executeRecommendStackDemo( input: RecommendStackDemoInput ): { text: string; isError?: boolean } { const { projectType, scale = 'mvp' } = input; debug('recommend_stack_demo called', { projectType, scale }); // Check rate limit if (wasDemoUsedToday()) { const deviceId = getDeviceId(); return { text: `## Daily Demo Limit Reached You've already used your free demo today. **Options:** 1. Come back tomorrow for another free demo 2. Create a free account at https://stacksfinder.com/register 3. Upgrade to Pro for unlimited recommendations: https://stacksfinder.com/pricing **Pro benefits:** - Unlimited stack recommendations - Custom priorities (time-to-market, scalability, security, etc.) - Technology constraints - AI-generated implementation narratives - API access for automation - MCP integration with full features --- *Device ID: ${deviceId.slice(0, 8)}...*`, isError: true }; } // Get categories for this project type const categories = PROJECT_TYPE_CATEGORIES[projectType] || ['meta-framework', 'database', 'auth', 'hosting']; // Get scoring context const context = scaleToContext(scale); // Select best tech per category const recommendations = selectBestTechPerCategory(categories, context, projectType); // Record usage recordDemoUsage(); // Format response const projectLabel = projectType.replace(/-/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase()); let text = `## Recommended Stack for ${projectLabel} (${scale}) | Category | Technology | Score | Grade | |----------|------------|-------|-------| `; for (const rec of recommendations) { text += `| ${rec.category} | ${rec.technology} | ${rec.score} | ${rec.grade} |\n`; } text += ` **Confidence**: medium (demo mode - no priorities/constraints applied) --- ### Want More? This is a **simplified demo**. The full version includes: - Custom priorities (time-to-market, scalability, security, etc.) - Technology constraints ("must use PostgreSQL", "no AWS") - Compatibility scoring between all selected technologies - AI-generated implementation narrative with setup guides - Confidence scoring (high/medium/low) based on your inputs **Upgrade to Pro**: https://stacksfinder.com/pricing **Create free account**: https://stacksfinder.com/register --- *Data version: ${DATA_VERSION} | Demo (1/day limit)*`; return { text }; }
• src/tools/recommend-demo.ts:37-40 (schema)

  Zod input schema defining the parameters for the recommend_stack_demo tool: projectType (required enum) and scale (optional enum defaulting to 'mvp').
  export const RecommendStackDemoInputSchema = z.object({ projectType: z.enum(PROJECT_TYPES).describe('Type of project'), scale: z.enum(SCALES).optional().default('mvp').describe('Project scale') });
• src/server.ts:110-141 (registration)

  MCP server registration of the recommend_stack_demo tool, including title, description, input schema override, and wrapper handler that parses args with schema and calls executeRecommendStackDemo.
  server.registerTool( recommendStackDemoToolDefinition.name, { title: 'Recommend Stack (Demo)', description: recommendStackDemoToolDefinition.description, inputSchema: { projectType: z .enum([ 'web-app', 'mobile-app', 'api', 'desktop', 'cli', 'library', 'e-commerce', 'saas', 'marketplace' ]) .describe('Type of project'), scale: z.enum(['mvp', 'startup', 'growth', 'enterprise']).optional().describe('Project scale') } }, async (args) => { debug('recommend_stack_demo called', args); const input = RecommendStackDemoInputSchema.parse(args); const { text, isError } = executeRecommendStackDemo(input); return { content: [{ type: 'text', text }], isError }; } );
• src/tools/recommend-demo.ts:47-69 (schema)

  Tool definition object used for MCP registration, providing name, description, and JSON schema compatible inputSchema. Note: Zod schema is used separately for runtime validation.
  export const recommendStackDemoToolDefinition = { name: 'recommend_stack_demo', description: `Try StacksFinder's tech stack recommendations for FREE - once per day, no account required. Returns the optimal technology for each category based on deterministic scoring. For unlimited access, priorities, constraints, and AI-generated narratives, upgrade to Pro at https://stacksfinder.com/pricing`, inputSchema: { type: 'object' as const, properties: { projectType: { type: 'string', enum: PROJECT_TYPES, description: 'Type of project (e.g., saas, web-app, api)' }, scale: { type: 'string', enum: SCALES, description: 'Project scale (mvp, startup, growth, enterprise)' } }, required: ['projectType'] } };
• src/tools/recommend-demo.ts:114-157 (helper)

  Helper function that selects the best technology for each category by computing weighted overall scores based on project type weights and scoring context, then formats results with grades.
  function selectBestTechPerCategory( categories: Category[], context: Context, projectType: string ): Array<{ category: Category; technology: string; score: number; grade: string }> { const results: Array<{ category: Category; technology: string; score: number; grade: string }> = []; const weights = PROJECT_TYPE_WEIGHTS[projectType] || {}; for (const category of categories) { const techs = getTechnologiesByCategory(category); if (techs.length === 0) continue; let bestTech = techs[0]; let bestScore = 0; for (const tech of techs) { const scores = getScores(tech.id, context); if (!scores) continue; let overall = calculateOverallScore(scores); // Apply project-type specific weight const weight = weights[category] || 1.0; overall = Math.round(overall * weight); if (overall > bestScore) { bestScore = overall; bestTech = tech; } } const finalScores = getScores(bestTech.id, context); const finalScore = finalScores ? calculateOverallScore(finalScores) : 0; results.push({ category, technology: bestTech.name, score: finalScore, grade: scoreToGrade(finalScore) }); } return results; }