@stacksfinder/mcp-server 1.0.0

package/dist/tools/blueprint.js

@@ -0,0 +1,320 @@
+import { z } from 'zod';
+import { getBlueprintRequest, createBlueprintRequest, getJobStatusRequest } from '../utils/api-client.js';
+import { McpError, ErrorCode } from '../utils/errors.js';
+import { debug } from '../utils/logger.js';
+/**
+ * Input schema for get_blueprint tool.
+ */
+export const GetBlueprintInputSchema = z.object({
+    blueprintId: z.string().uuid().describe('Blueprint UUID')
+});
+/**
+ * Tool definition for MCP registration.
+ */
+export const getBlueprintToolDefinition = {
+    name: 'get_blueprint',
+    description: 'Fetches an existing blueprint by ID. Blueprints are generated via the StacksFinder web UI. Requires API key.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            blueprintId: {
+                type: 'string',
+                format: 'uuid',
+                description: 'Blueprint UUID'
+            }
+        },
+        required: ['blueprintId']
+    }
+};
+/**
+ * Format blueprint for MCP output.
+ */
+function formatBlueprint(blueprint) {
+    const projectName = blueprint.projectContext?.projectName || 'Unnamed Project';
+    const projectType = blueprint.projectContext?.projectType || 'Unknown';
+    const scale = blueprint.projectContext?.scale || 'mvp';
+    const createdDate = new Date(blueprint.createdAt).toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric'
+    });
+    let text = `## Blueprint: ${projectName}
+
+**ID**: ${blueprint.id}
+**Type**: ${projectType}
+**Scale**: ${scale}
+**Created**: ${createdDate}
+
+### Selected Stack
+| Category | Technology |
+|----------|------------|
+`;
+    for (const tech of blueprint.selectedTechs) {
+        text += `| ${tech.category} | ${tech.technology} |\n`;
+    }
+    if (blueprint.narrative) {
+        text += `
+### Narrative
+${blueprint.narrative}`;
+    }
+    return text;
+}
+/**
+ * Execute get_blueprint tool.
+ */
+export async function executeGetBlueprint(input) {
+    const { blueprintId } = input;
+    debug('Fetching blueprint', { blueprintId });
+    try {
+        const response = await getBlueprintRequest(blueprintId);
+        const text = formatBlueprint(response);
+        return { text };
+    }
+    catch (err) {
+        if (err instanceof McpError) {
+            // Add helpful suggestion for NOT_FOUND
+            if (err.code === ErrorCode.NOT_FOUND) {
+                err.suggestions = [
+                    'Blueprints are generated via the StacksFinder web UI.',
+                    'Visit https://stacksfinder.com to create a new blueprint.'
+                ];
+            }
+            return { text: err.toResponseText(), isError: true };
+        }
+        const error = new McpError(ErrorCode.API_ERROR, err instanceof Error ? err.message : 'Failed to fetch blueprint');
+        return { text: error.toResponseText(), isError: true };
+    }
+}
+// ============================================================================
+// CREATE BLUEPRINT TOOL
+// ============================================================================
+/**
+ * Valid project types for blueprint creation.
+ */
+const PROJECT_TYPES = [
+    'web-app',
+    'mobile-app',
+    'api',
+    'desktop',
+    'cli',
+    'library',
+    'e-commerce',
+    'saas',
+    'marketplace'
+];
+/**
+ * Valid scales for blueprint creation.
+ */
+const SCALES = ['mvp', 'startup', 'growth', 'enterprise'];
+/**
+ * Valid priorities for blueprint creation.
+ */
+const PRIORITIES = [
+    'time-to-market',
+    'scalability',
+    'developer-experience',
+    'cost-efficiency',
+    'performance',
+    'security',
+    'maintainability'
+];
+/**
+ * Input schema for create_blueprint tool.
+ */
+export const CreateBlueprintInputSchema = z.object({
+    projectName: z.string().min(1).max(100).optional().describe('Project name (optional)'),
+    projectType: z
+        .enum(PROJECT_TYPES)
+        .describe('Type of project (e.g., web-app, saas, api)'),
+    scale: z.enum(SCALES).describe('Project scale (mvp, startup, growth, enterprise)'),
+    projectDescription: z
+        .string()
+        .max(2000)
+        .optional()
+        .describe('Brief project description (optional)'),
+    priorities: z
+        .array(z.enum(PRIORITIES))
+        .max(3)
+        .optional()
+        .describe('Top 3 priorities (optional)'),
+    constraints: z
+        .array(z.string())
+        .max(20)
+        .optional()
+        .describe('Technology constraint IDs (optional)'),
+    waitForCompletion: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Wait for blueprint generation to complete (default: true)')
+});
+/**
+ * Tool definition for MCP registration.
+ */
+export const createBlueprintToolDefinition = {
+    name: 'create_blueprint',
+    description: `Creates a new tech stack blueprint for a project. Requires API key with 'blueprint:write' scope.
+
+The blueprint generation is asynchronous. By default, this tool waits for completion and returns the full blueprint.
+Set waitForCompletion=false to get the job ID immediately for manual polling.
+
+Example usage:
+- Create a SaaS MVP: projectType="saas", scale="mvp", priorities=["time-to-market", "cost-efficiency"]
+- Create an enterprise API: projectType="api", scale="enterprise", priorities=["security", "scalability"]`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectName: {
+                type: 'string',
+                description: 'Project name (optional)',
+                maxLength: 100
+            },
+            projectType: {
+                type: 'string',
+                enum: PROJECT_TYPES,
+                description: 'Type of project'
+            },
+            scale: {
+                type: 'string',
+                enum: SCALES,
+                description: 'Project scale'
+            },
+            projectDescription: {
+                type: 'string',
+                description: 'Brief project description (optional)',
+                maxLength: 2000
+            },
+            priorities: {
+                type: 'array',
+                items: { type: 'string', enum: PRIORITIES },
+                maxItems: 3,
+                description: 'Top 3 priorities (optional)'
+            },
+            constraints: {
+                type: 'array',
+                items: { type: 'string' },
+                maxItems: 20,
+                description: 'Technology constraint IDs (optional)'
+            },
+            waitForCompletion: {
+                type: 'boolean',
+                description: 'Wait for blueprint generation to complete (default: true)',
+                default: true
+            }
+        },
+        required: ['projectType', 'scale']
+    }
+};
+/**
+ * Poll job status until completion or failure.
+ */
+async function pollJobUntilComplete(jobId, maxAttempts = 30, intervalMs = 2000) {
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const status = await getJobStatusRequest(jobId);
+        if (status.status === 'completed') {
+            return status;
+        }
+        if (status.status === 'failed' || status.status === 'cancelled') {
+            throw new McpError(ErrorCode.API_ERROR, status.errorMessage || `Job ${status.status}: ${status.errorCode || 'Unknown error'}`);
+        }
+        // Wait before next poll
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+    throw new McpError(ErrorCode.TIMEOUT, `Blueprint generation timed out after ${(maxAttempts * intervalMs) / 1000} seconds`, ['The job is still running. Use get_blueprint with the job resultRef to check later.']);
+}
+/**
+ * Execute create_blueprint tool.
+ */
+export async function executeCreateBlueprint(input) {
+    const { projectName, projectType, scale, projectDescription, priorities, constraints, waitForCompletion = true } = input;
+    debug('Creating blueprint', { projectType, scale, waitForCompletion });
+    try {
+        // Build request body
+        const requestBody = {
+            projectName,
+            projectContext: {
+                projectName,
+                projectType,
+                projectDescription,
+                scale,
+                priorities: priorities,
+                constraintIds: constraints
+            },
+            source: 'mcp',
+            mcpToolName: 'create_blueprint'
+        };
+        // Create the blueprint job
+        const createResponse = await createBlueprintRequest(requestBody);
+        // If already completed (cached result), fetch and return
+        if (createResponse.status === 'completed' && createResponse.resultRef) {
+            const blueprint = await getBlueprintRequest(createResponse.resultRef);
+            const text = formatBlueprint(blueprint);
+            return {
+                text: `## Blueprint Created (Cached)\n\n${text}\n\n---\n*Source: MCP Server*`
+            };
+        }
+        // If not waiting, return job info
+        if (!waitForCompletion) {
+            return {
+                text: `## Blueprint Generation Started
+
+**Job ID**: ${createResponse.jobId}
+**Project ID**: ${createResponse.projectId}
+**Status**: ${createResponse.status}
+**Progress**: ${createResponse.progress}%
+
+Poll the job status at: ${createResponse._links.job}
+Once complete, fetch the blueprint at: ${createResponse._links.blueprint || 'TBD'}
+
+---
+*Source: MCP Server*`
+            };
+        }
+        // Poll until completion
+        debug('Polling job until completion', { jobId: createResponse.jobId });
+        const finalStatus = await pollJobUntilComplete(createResponse.jobId);
+        if (!finalStatus.resultRef) {
+            throw new McpError(ErrorCode.API_ERROR, 'Job completed but no blueprint ID returned');
+        }
+        // Fetch the completed blueprint
+        const blueprint = await getBlueprintRequest(finalStatus.resultRef);
+        const text = formatBlueprint(blueprint);
+        return {
+            text: `## Blueprint Created Successfully
+
+${text}
+
+---
+**Job ID**: ${createResponse.jobId}
+**Project ID**: ${createResponse.projectId}
+*Source: MCP Server*`
+        };
+    }
+    catch (err) {
+        if (err instanceof McpError) {
+            // Add helpful suggestions for common errors
+            if (err.code === ErrorCode.CONFIG_ERROR) {
+                err.suggestions = [
+                    'Ensure STACKSFINDER_API_KEY is set with a valid Pro or Team API key.',
+                    'Get your API key from https://stacksfinder.com/settings/api'
+                ];
+            }
+            else if (err.code === ErrorCode.UNAUTHORIZED) {
+                err.suggestions = [
+                    "Your API key may be invalid or missing the 'blueprint:write' scope.",
+                    'Generate a new API key with the correct permissions at https://stacksfinder.com/settings/api'
+                ];
+            }
+            else if (err.code === ErrorCode.RATE_LIMITED) {
+                err.suggestions = [
+                    'You have exceeded your monthly blueprint quota.',
+                    'Upgrade your plan at https://stacksfinder.com/pricing'
+                ];
+            }
+            return { text: err.toResponseText(), isError: true };
+        }
+        const error = new McpError(ErrorCode.API_ERROR, err instanceof Error ? err.message : 'Failed to create blueprint');
+        return { text: error.toResponseText(), isError: true };
+    }
+}
+//# sourceMappingURL=blueprint.js.map

package/dist/tools/blueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.js","sourceRoot":"","sources":["../../src/tools/blueprint.ts"],"names":[],"mappings":"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"}

package/dist/tools/compare.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+/**
+ * Input schema for compare_techs tool.
+ */
+export declare const CompareTechsInputSchema: z.ZodObject<{
+    technologies: z.ZodArray<z.ZodString, "many">;
+    context: z.ZodDefault<z.ZodOptional<z.ZodEnum<["default", "mvp", "enterprise"]>>>;
+}, "strip", z.ZodTypeAny, {
+    context: "default" | "mvp" | "enterprise";
+    technologies: string[];
+}, {
+    technologies: string[];
+    context?: "default" | "mvp" | "enterprise" | undefined;
+}>;
+export type CompareTechsInput = z.infer<typeof CompareTechsInputSchema>;
+/**
+ * Tool definition for MCP registration.
+ */
+export declare const compareTechsToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            technologies: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                minItems: number;
+                maxItems: number;
+                description: string;
+            };
+            context: {
+                type: string;
+                enum: readonly ["default", "mvp", "enterprise"];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Execute compare_techs tool.
+ */
+export declare function executeCompareTechs(input: CompareTechsInput): {
+    text: string;
+    isError?: boolean;
+};
+//# sourceMappingURL=compare.d.ts.map

package/dist/tools/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/tools/compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;EAOlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;CAqBtC,CAAC;AAuDF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CA4GjG"}

package/dist/tools/compare.js

@@ -0,0 +1,168 @@
+import { z } from 'zod';
+import { CONTEXTS, DATA_VERSION, DIMENSION_LABELS, SCORE_DIMENSIONS, calculateOverallScore, getAllTechIds, getCompatibility, getCompatibilityVerdict, getScores, getTechnology, scoreToGrade, techExists } from '../data/index.js';
+import { McpError, ErrorCode, techNotFoundError } from '../utils/errors.js';
+/**
+ * Input schema for compare_techs tool.
+ */
+export const CompareTechsInputSchema = z.object({
+    technologies: z
+        .array(z.string().min(1))
+        .min(2)
+        .max(4)
+        .describe('Technology IDs to compare (2-4 technologies)'),
+    context: z.enum(CONTEXTS).optional().default('default').describe('Context for score lookup')
+});
+/**
+ * Tool definition for MCP registration.
+ */
+export const compareTechsToolDefinition = {
+    name: 'compare_techs',
+    description: 'Side-by-side comparison of 2-4 technologies with per-dimension winners and compatibility matrix.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            technologies: {
+                type: 'array',
+                items: { type: 'string' },
+                minItems: 2,
+                maxItems: 4,
+                description: 'Technology IDs to compare (e.g., ["nextjs", "sveltekit", "nuxt"])'
+            },
+            context: {
+                type: 'string',
+                enum: CONTEXTS,
+                description: 'Context for scoring (default, mvp, enterprise)'
+            }
+        },
+        required: ['technologies']
+    }
+};
+/**
+ * Determine winner for each dimension.
+ */
+function determineDimensionWinners(techs) {
+    const winners = [];
+    for (const dim of SCORE_DIMENSIONS) {
+        const sorted = [...techs].sort((a, b) => b.scores[dim] - a.scores[dim]);
+        const first = sorted[0];
+        const second = sorted[1];
+        const margin = first.scores[dim] - second.scores[dim];
+        let winner;
+        let notes;
+        if (margin < 3) {
+            // Tie if margin is less than 3
+            winner = null;
+            notes = 'Tie';
+        }
+        else if (margin < 10) {
+            winner = first.name;
+            notes = 'Close competition';
+        }
+        else {
+            winner = first.name;
+            notes = 'Clear winner';
+        }
+        winners.push({
+            dimension: DIMENSION_LABELS[dim],
+            winner,
+            margin,
+            notes
+        });
+    }
+    return winners;
+}
+/**
+ * Execute compare_techs tool.
+ */
+export function executeCompareTechs(input) {
+    const { technologies, context = 'default' } = input;
+    // Validate all technologies exist
+    const allTechIds = getAllTechIds();
+    const invalidTechs = [];
+    for (const techId of technologies) {
+        if (!techExists(techId)) {
+            invalidTechs.push(techId);
+        }
+    }
+    if (invalidTechs.length > 0) {
+        const error = techNotFoundError(invalidTechs[0], allTechIds);
+        return { text: error.toResponseText(), isError: true };
+    }
+    // Check for duplicates
+    const uniqueTechs = [...new Set(technologies)];
+    if (uniqueTechs.length !== technologies.length) {
+        const error = new McpError(ErrorCode.INVALID_INPUT, 'Duplicate technologies in comparison list');
+        return { text: error.toResponseText(), isError: true };
+    }
+    // Build comparison data
+    const comparisons = technologies.map((techId) => {
+        const tech = getTechnology(techId);
+        const scores = getScores(techId, context);
+        const overall = calculateOverallScore(scores);
+        return {
+            id: techId,
+            name: tech.name,
+            scores,
+            overall,
+            grade: scoreToGrade(overall)
+        };
+    });
+    // Sort by overall score
+    const sorted = [...comparisons].sort((a, b) => b.overall - a.overall);
+    // Determine dimension winners
+    const dimensionWinners = determineDimensionWinners(comparisons);
+    // Build response
+    const techNames = comparisons.map((t) => t.name).join(' vs ');
+    let text = `## Comparison: ${techNames} (context: ${context})
+
+### Overall Scores
+| Technology | Score | Grade |
+|------------|-------|-------|
+`;
+    for (const tech of sorted) {
+        text += `| ${tech.name} | ${tech.overall} | ${tech.grade} |\n`;
+    }
+    // Per-dimension breakdown
+    text += `
+### Per-Dimension Winners
+| Dimension | Winner | Margin | Notes |
+|-----------|--------|--------|-------|
+`;
+    for (const w of dimensionWinners) {
+        const winnerDisplay = w.winner ?? 'Tie';
+        const marginDisplay = w.winner ? `+${w.margin}` : '-';
+        text += `| ${w.dimension} | ${winnerDisplay} | ${marginDisplay} | ${w.notes} |\n`;
+    }
+    // Compatibility matrix (for all pairs)
+    text += '\n### Compatibility Matrix\n| Pair | Score | Verdict |\n|------|-------|---------|\n';
+    for (let i = 0; i < comparisons.length; i++) {
+        for (let j = i + 1; j < comparisons.length; j++) {
+            const a = comparisons[i];
+            const b = comparisons[j];
+            const score = getCompatibility(a.id, b.id);
+            const verdict = getCompatibilityVerdict(score);
+            text += `| ${a.id} ↔ ${b.id} | ${score} | ${verdict} |\n`;
+        }
+    }
+    // Verdict
+    const leader = sorted[0];
+    const runnerUp = sorted[1];
+    const overallMargin = leader.overall - runnerUp.overall;
+    text += '\n';
+    if (overallMargin < 3) {
+        text += `**Verdict**: Close call between ${leader.name} and ${runnerUp.name}\n`;
+        text += `**Recommendation**: Both are strong choices; consider your specific priorities.`;
+    }
+    else {
+        text += `**Verdict**: ${leader.name} leads with ${leader.overall}/100\n`;
+        // Find what leader is best at
+        const leaderStrengths = dimensionWinners.filter((w) => w.winner === leader.name).map((w) => w.dimension);
+        if (leaderStrengths.length > 0) {
+            const strengthsText = leaderStrengths.slice(0, 2).join(' and ');
+            text += `**Recommendation**: Consider ${leader.name} for ${strengthsText} priorities.`;
+        }
+    }
+    text += `\n\nData version: ${DATA_VERSION}`;
+    return { text };
+}
+//# sourceMappingURL=compare.js.map

package/dist/tools/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/tools/compare.ts"],"names":[],"mappings":"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"}

package/dist/tools/list-techs.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+/**
+ * Input schema for list_technologies tool.
+ */
+export declare const ListTechsInputSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodEnum<["frontend", "backend", "meta-framework", "database", "orm", "auth", "hosting", "payments"]>>;
+}, "strip", z.ZodTypeAny, {
+    category?: "frontend" | "backend" | "meta-framework" | "database" | "orm" | "auth" | "hosting" | "payments" | undefined;
+}, {
+    category?: "frontend" | "backend" | "meta-framework" | "database" | "orm" | "auth" | "hosting" | "payments" | undefined;
+}>;
+export type ListTechsInput = z.infer<typeof ListTechsInputSchema>;
+/**
+ * Tool definition for MCP registration.
+ */
+export declare const listTechsToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            category: {
+                type: string;
+                enum: readonly ["frontend", "backend", "meta-framework", "database", "orm", "auth", "hosting", "payments"];
+                description: string;
+            };
+        };
+    };
+};
+/**
+ * Execute list_technologies tool.
+ */
+export declare function executeListTechs(input: ListTechsInput): string;
+//# sourceMappingURL=list-techs.d.ts.map

package/dist/tools/list-techs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-techs.d.ts","sourceRoot":"","sources":["../../src/tools/list-techs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;EAK/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;CAcnC,CAAC;AAYF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAyC9D"}

package/dist/tools/list-techs.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { CATEGORIES, DATA_VERSION, getTechnologiesByCategory, getTechnologiesGroupedByCategory } from '../data/index.js';
+/**
+ * Input schema for list_technologies tool.
+ */
+export const ListTechsInputSchema = z.object({
+    category: z
+        .enum(CATEGORIES)
+        .optional()
+        .describe('Filter by category. Omit to list all technologies.')
+});
+/**
+ * Tool definition for MCP registration.
+ */
+export const listTechsToolDefinition = {
+    name: 'list_technologies',
+    description: 'Lists all available technology IDs for use with other tools. Essential for discovering valid technology identifiers.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            category: {
+                type: 'string',
+                enum: CATEGORIES,
+                description: 'Filter by category (optional)'
+            }
+        }
+    }
+};
+/**
+ * Format technologies for a single category.
+ */
+function formatCategory(category, techs) {
+    if (techs.length === 0)
+        return '';
+    const lines = techs.map((t) => `- ${t.id} (${t.name})`);
+    return `## ${category}\n${lines.join('\n')}`;
+}
+/**
+ * Execute list_technologies tool.
+ */
+export function executeListTechs(input) {
+    const { category } = input;
+    if (category) {
+        // Filter by specific category
+        const techs = getTechnologiesByCategory(category);
+        const formatted = formatCategory(category, techs.map((t) => ({ id: t.id, name: t.name })));
+        return `Available technologies in "${category}" (${techs.length} total):
+
+${formatted}
+
+Data version: ${DATA_VERSION}`;
+    }
+    // List all technologies grouped by category
+    const grouped = getTechnologiesGroupedByCategory();
+    const sections = [];
+    let total = 0;
+    for (const cat of CATEGORIES) {
+        const techs = grouped[cat];
+        if (techs.length > 0) {
+            sections.push(formatCategory(cat, techs.map((t) => ({ id: t.id, name: t.name }))));
+            total += techs.length;
+        }
+    }
+    return `Available technologies (${total} total):
+
+${sections.join('\n\n')}
+
+Data version: ${DATA_VERSION}`;
+}
+//# sourceMappingURL=list-techs.js.map