stacksfinder-mcp

Instructions

Implementation Reference

• src/tools/analyze.ts:82-145 (handler)

  Main execution handler for analyze_tech tool. Validates input, retrieves technology data and scores from data layer, computes overall score, strengths, weaknesses, compatible techs, and formats a detailed Markdown analysis report.
  export function executeAnalyzeTech(input: AnalyzeTechInput): { text: string; isError?: boolean } { const { technology, context = 'default' } = input; // Check if technology exists if (!techExists(technology)) { const error = techNotFoundError(technology, getAllTechIds()); return { text: error.toResponseText(), isError: true }; } const tech = getTechnology(technology)!; const scores = getScores(technology, context)!; const overallScore = calculateOverallScore(scores); const grade = scoreToGrade(overallScore); // Get strengths and weaknesses const { strengths, weaknesses } = analyzeStrengthsWeaknesses(scores); // Get compatible technologies const compatible = findCompatibleTechs(technology); // Build response let text = `## ${tech.name} Analysis (context: ${context}) **Category**: ${tech.category} **Overall Score**: ${overallScore}/100 (${grade}) **URL**: ${tech.url} ### Scores by Dimension | Dimension | Score | Grade | |-----------|-------|-------| `; for (const dim of SCORE_DIMENSIONS) { const score = scores[dim]; text += `| ${DIMENSION_LABELS[dim]} | ${score} | ${scoreToGrade(score)} |\n`; } // Strengths if (strengths.length > 0) { text += '\n### Strengths\n'; for (const s of strengths) { text += `- **${s.dim}** (${s.score}/100)\n`; } } // Weaknesses if (weaknesses.length > 0) { text += '\n### Weaknesses\n'; for (const w of weaknesses) { text += `- ${w.dim} (${w.score}/100)\n`; } } // Compatible technologies if (compatible.length > 0) { text += '\n### Compatible Technologies (top 8)\n'; const compatList = compatible.map((c) => `${c.id} (${c.score})`).join(', '); text += `${compatList}\n`; } text += `\nData version: ${DATA_VERSION}`; return { text }; }
• src/tools/analyze.ts:18-24 (schema)

  Zod input schema for validating analyze_tech tool parameters: technology ID and optional context.
  /** * Input schema for analyze_tech tool. */ export const AnalyzeTechInputSchema = z.object({ technology: z.string().min(1).describe('Technology ID to analyze (e.g., "nextjs", "postgres")'), context: z.enum(CONTEXTS).optional().default('default').describe('Context for score lookup') });
• src/server.ts:66-85 (registration)

  MCP server registration of the analyze_tech tool, including tool metadata, input schema, and handler invocation using executeAnalyzeTech.
  server.registerTool( analyzeTechToolDefinition.name, { title: 'Analyze Technology', description: analyzeTechToolDefinition.description, inputSchema: { technology: z.string().min(1).describe('Technology ID to analyze'), context: z.enum(CONTEXTS).optional().describe('Context for scoring') } }, async (args) => { debug('analyze_tech called', args); const input = AnalyzeTechInputSchema.parse(args); const { text, isError } = executeAnalyzeTech(input); return { content: [{ type: 'text', text }], isError }; } );
• src/tools/analyze.ts:28-50 (schema)

  Tool definition object with name, description, and JSON input schema used for MCP tool registration.
  /** * Tool definition for MCP registration. */ export const analyzeTechToolDefinition = { name: 'analyze_tech', description: 'Detailed analysis of a technology with 6-dimension scores, strengths, weaknesses, and compatible technologies.', inputSchema: { type: 'object' as const, properties: { technology: { type: 'string', description: 'Technology ID (e.g., "nextjs", "postgres", "drizzle")' }, context: { type: 'string', enum: CONTEXTS, description: 'Context for scoring (default, mvp, enterprise)' } }, required: ['technology'] } };
• src/tools/analyze.ts:52-77 (helper)

  Helper function to compute strengths (top 2 scores >=85) and weaknesses (bottom 2 scores <80) from technology scores.
  /** * Identify strengths (top scores) and weaknesses (low scores). */ function analyzeStrengthsWeaknesses( scores: Scores ): { strengths: Array<{ dim: string; score: number }>; weaknesses: Array<{ dim: string; score: number }> } { const sorted = SCORE_DIMENSIONS.map((dim) => ({ dim: DIMENSION_LABELS[dim], dimKey: dim, score: scores[dim] })).sort((a, b) => b.score - a.score); // Top 2 as strengths (if score >= 85) const strengths = sorted.filter((s) => s.score >= 85).slice(0, 2); // Bottom 2 as weaknesses (if score < 80) const weaknesses = sorted .reverse() .filter((s) => s.score < 80) .slice(0, 2); return { strengths: strengths.map((s) => ({ dim: s.dim, score: s.score })), weaknesses: weaknesses.map((s) => ({ dim: s.dim, score: s.score })) }; }