mcmodding-mcp 0.1.0 → 0.2.2

package/dist/services/mod-examples-service.js

@@ -0,0 +1,370 @@
+import Database from 'better-sqlite3';
+import * as fs from 'fs';
+import * as path from 'path';
+export class ModExamplesService {
+    db;
+    static dbPath = path.join(process.cwd(), 'data', 'mod-examples.db');
+    constructor(dbPath) {
+        const finalPath = dbPath || ModExamplesService.dbPath;
+        console.error(`[ModExamplesService] Using database at: ${finalPath}`);
+        this.db = new Database(finalPath, { readonly: true });
+    }
+    static isAvailable() {
+        return fs.existsSync(ModExamplesService.dbPath);
+    }
+    getStats() {
+        const stats = this.db
+            .prepare(`
+      SELECT
+        (SELECT COUNT(*) FROM mods) as mods,
+        (SELECT COUNT(*) FROM examples) as examples,
+        (SELECT COUNT(*) FROM example_relations) as relations,
+        (SELECT COUNT(*) FROM categories) as categories,
+        (SELECT COUNT(*) FROM examples WHERE is_featured = TRUE) as featuredExamples,
+        (SELECT AVG(quality_score) FROM examples) as avgQualityScore
+    `)
+            .get();
+        return {
+            ...stats,
+            avgQualityScore: Math.round((stats.avgQualityScore || 0) * 100) / 100,
+        };
+    }
+    listMods() {
+        const mods = this.db
+            .prepare(`
+      SELECT
+        m.id,
+        m.name,
+        m.repo,
+        m.loader,
+        m.description,
+        m.readme_summary as readmeSummary,
+        m.architecture_notes as architectureNotes,
+        m.star_count as starCount,
+        m.minecraft_versions as minecraftVersions,
+        COUNT(e.id) as exampleCount
+      FROM mods m
+      LEFT JOIN examples e ON e.mod_id = m.id
+      GROUP BY m.id
+      ORDER BY m.priority DESC, m.star_count DESC
+    `)
+            .all();
+        return mods.map((m) => ({
+            ...m,
+            minecraftVersions: JSON.parse(m.minecraftVersions || '[]'),
+        }));
+    }
+    getMod(name) {
+        const mod = this.db
+            .prepare(`
+      SELECT
+        m.id,
+        m.name,
+        m.repo,
+        m.loader,
+        m.description,
+        m.readme_summary as readmeSummary,
+        m.architecture_notes as architectureNotes,
+        m.star_count as starCount,
+        m.minecraft_versions as minecraftVersions,
+        COUNT(e.id) as exampleCount
+      FROM mods m
+      LEFT JOIN examples e ON e.mod_id = m.id
+      WHERE LOWER(m.name) = LOWER(?)
+      GROUP BY m.id
+    `)
+            .get(name);
+        if (!mod)
+            return null;
+        return {
+            ...mod,
+            minecraftVersions: JSON.parse(mod.minecraftVersions || '[]'),
+        };
+    }
+    listCategories() {
+        return this.db
+            .prepare(`
+      SELECT
+        c.slug,
+        c.name,
+        c.description,
+        c.icon,
+        COUNT(e.id) as exampleCount
+      FROM categories c
+      LEFT JOIN examples e ON e.category_id = c.id
+      GROUP BY c.id
+      HAVING exampleCount > 0
+      ORDER BY c.sort_order ASC
+    `)
+            .all();
+    }
+    searchExamples(options) {
+        const { query, modName, category, patternType, complexity, minQualityScore = 0, featured, tags, limit = 10, } = options;
+        let sql = `
+      SELECT DISTINCT
+        e.id,
+        m.name as modName,
+        m.repo as modRepo,
+        e.file_path as filePath,
+        e.file_url as fileUrl,
+        e.start_line as startLine,
+        e.end_line as endLine,
+        e.title,
+        e.code,
+        e.language,
+        e.caption,
+        e.explanation,
+        e.pattern_type as patternType,
+        e.complexity,
+        c.slug as category,
+        c.name as categoryName,
+        e.best_practices as bestPractices,
+        e.potential_pitfalls as potentialPitfalls,
+        e.use_cases as useCases,
+        e.keywords,
+        e.minecraft_concepts as minecraftConcepts,
+        e.quality_score as qualityScore,
+        e.is_featured as isFeatured
+      FROM examples e
+      JOIN mods m ON e.mod_id = m.id
+      LEFT JOIN categories c ON e.category_id = c.id
+    `;
+        const conditions = [];
+        const params = [];
+        if (query && query.trim()) {
+            sql += ` JOIN examples_fts fts ON fts.rowid = e.id`;
+            conditions.push(`examples_fts MATCH ?`);
+            const ftsQuery = query
+                .split(/\s+/)
+                .filter((t) => t.length > 1)
+                .map((t) => `"${t}"*`)
+                .join(' OR ');
+            params.push(ftsQuery || query);
+        }
+        if (modName) {
+            conditions.push(`LOWER(m.name) = LOWER(?)`);
+            params.push(modName);
+        }
+        if (category) {
+            conditions.push(`c.slug = ?`);
+            params.push(category);
+        }
+        if (patternType) {
+            conditions.push(`e.pattern_type = ?`);
+            params.push(patternType);
+        }
+        if (complexity) {
+            conditions.push(`e.complexity = ?`);
+            params.push(complexity);
+        }
+        if (minQualityScore > 0) {
+            conditions.push(`e.quality_score >= ?`);
+            params.push(minQualityScore);
+        }
+        if (featured !== undefined) {
+            conditions.push(`e.is_featured = ?`);
+            params.push(featured ? 1 : 0);
+        }
+        if (tags && tags.length > 0) {
+            sql += ` JOIN example_tags et ON et.example_id = e.id JOIN tags t ON t.id = et.tag_id`;
+            conditions.push(`t.slug IN (${tags.map(() => '?').join(', ')})`);
+            params.push(...tags);
+        }
+        if (conditions.length > 0) {
+            sql += ` WHERE ${conditions.join(' AND ')}`;
+        }
+        sql += ` ORDER BY e.quality_score DESC, e.is_featured DESC LIMIT ?`;
+        params.push(limit);
+        const examples = this.db.prepare(sql).all(...params);
+        return examples.map((e) => this.enrichExample(e));
+    }
+    getExample(id) {
+        const example = this.db
+            .prepare(`
+      SELECT
+        e.id,
+        m.name as modName,
+        m.repo as modRepo,
+        e.file_path as filePath,
+        e.file_url as fileUrl,
+        e.start_line as startLine,
+        e.end_line as endLine,
+        e.title,
+        e.code,
+        e.language,
+        e.caption,
+        e.explanation,
+        e.pattern_type as patternType,
+        e.complexity,
+        c.slug as category,
+        c.name as categoryName,
+        e.best_practices as bestPractices,
+        e.potential_pitfalls as potentialPitfalls,
+        e.use_cases as useCases,
+        e.keywords,
+        e.minecraft_concepts as minecraftConcepts,
+        e.quality_score as qualityScore,
+        e.is_featured as isFeatured
+      FROM examples e
+      JOIN mods m ON e.mod_id = m.id
+      LEFT JOIN categories c ON e.category_id = c.id
+      WHERE e.id = ?
+    `)
+            .get(id);
+        if (!example)
+            return null;
+        return this.enrichExample(example);
+    }
+    getRelatedExamples(exampleId) {
+        return this.db
+            .prepare(`
+      SELECT
+        r.source_id as sourceId,
+        r.target_id as targetId,
+        r.relation_type as relationType,
+        r.description,
+        r.strength,
+        e.title as targetTitle,
+        e.caption as targetCaption
+      FROM example_relations r
+      JOIN examples e ON e.id = r.target_id
+      WHERE r.source_id = ?
+      ORDER BY r.strength DESC
+    `)
+            .all(exampleId);
+    }
+    getFeaturedExamples(limit = 10) {
+        return this.searchExamples({
+            featured: true,
+            minQualityScore: 0.7,
+            limit,
+        });
+    }
+    getExamplesByPattern(patternType, limit = 10) {
+        return this.searchExamples({
+            patternType,
+            minQualityScore: 0.5,
+            limit,
+        });
+    }
+    getPatternTypes() {
+        return this.db
+            .prepare(`
+      SELECT pattern_type as type, COUNT(*) as count
+      FROM examples
+      WHERE pattern_type IS NOT NULL
+      GROUP BY pattern_type
+      ORDER BY count DESC
+    `)
+            .all();
+    }
+    enrichExample(example) {
+        const tags = this.db
+            .prepare(`
+      SELECT t.slug
+      FROM tags t
+      JOIN example_tags et ON et.tag_id = t.id
+      WHERE et.example_id = ?
+    `)
+            .all(example.id);
+        const imports = this.db
+            .prepare(`
+      SELECT import_path as path, import_type as type, is_critical as isCritical
+      FROM example_imports
+      WHERE example_id = ?
+    `)
+            .all(example.id);
+        const apiRefs = this.db
+            .prepare(`
+      SELECT class_name as className, method_name as methodName, api_type as apiType
+      FROM api_references
+      WHERE example_id = ?
+    `)
+            .all(example.id);
+        return {
+            ...example,
+            bestPractices: JSON.parse(example.bestPractices || '[]'),
+            potentialPitfalls: JSON.parse(example.potentialPitfalls || '[]'),
+            useCases: JSON.parse(example.useCases || '[]'),
+            keywords: JSON.parse(example.keywords || '[]'),
+            minecraftConcepts: JSON.parse(example.minecraftConcepts || '[]'),
+            tags: tags.map((t) => t.slug),
+            imports: imports.map((i) => ({ ...i, isCritical: Boolean(i.isCritical) })),
+            apiReferences: apiRefs.map((r) => ({
+                className: r.className,
+                methodName: r.methodName || undefined,
+                apiType: r.apiType,
+            })),
+        };
+    }
+    formatExampleForAI(example) {
+        let output = '';
+        output += `## ${example.title}\n\n`;
+        output += `**Source:** ${example.modName} (${example.modRepo})\n`;
+        output += `**File:** [${example.filePath}](${example.fileUrl}) (lines ${example.startLine}-${example.endLine})\n`;
+        output += `**Category:** ${example.categoryName || example.category}\n`;
+        output += `**Pattern:** ${example.patternType}\n`;
+        output += `**Complexity:** ${example.complexity}\n`;
+        output += `**Quality Score:** ${(example.qualityScore * 100).toFixed(0)}%\n`;
+        if (example.isFeatured) {
+            output += `**Featured:** Yes (curated high-quality example)\n`;
+        }
+        if (example.tags.length > 0) {
+            output += `**Tags:** ${example.tags.join(', ')}\n`;
+        }
+        output += `\n### Description\n${example.caption}\n`;
+        if (example.explanation) {
+            output += `\n### Detailed Explanation\n${example.explanation}\n`;
+        }
+        output += `\n### Code\n\`\`\`${example.language}\n${example.code}\n\`\`\`\n`;
+        if (example.bestPractices.length > 0) {
+            output += `\n### Best Practices\n`;
+            example.bestPractices.forEach((bp) => {
+                output += `- ${bp}\n`;
+            });
+        }
+        if (example.potentialPitfalls.length > 0) {
+            output += `\n### Potential Pitfalls\n`;
+            example.potentialPitfalls.forEach((pp) => {
+                output += `- ⚠️ ${pp}\n`;
+            });
+        }
+        if (example.useCases.length > 0) {
+            output += `\n### When to Use\n`;
+            example.useCases.forEach((uc) => {
+                output += `- ${uc}\n`;
+            });
+        }
+        if (example.minecraftConcepts.length > 0) {
+            output += `\n### Minecraft Concepts Used\n`;
+            output += example.minecraftConcepts.join(', ') + '\n';
+        }
+        if (example.imports.length > 0) {
+            const criticalImports = example.imports.filter((i) => i.isCritical);
+            if (criticalImports.length > 0) {
+                output += `\n### Required Imports\n\`\`\`java\n`;
+                criticalImports.forEach((i) => {
+                    output += `import ${i.path};\n`;
+                });
+                output += `\`\`\`\n`;
+            }
+        }
+        return output;
+    }
+    formatExamplesForAI(examples) {
+        if (examples.length === 0) {
+            return 'No mod examples found matching your criteria.\n\nTry:\n- Using broader search terms\n- Removing filters\n- Checking available categories with list_mod_categories';
+        }
+        let output = `Found ${examples.length} canonical mod example${examples.length > 1 ? 's' : ''}:\n\n`;
+        examples.forEach((example, index) => {
+            output += `---\n\n`;
+            output += `### Example ${index + 1} of ${examples.length}\n\n`;
+            output += this.formatExampleForAI(example);
+        });
+        return output;
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=mod-examples-service.js.map

package/dist/services/mod-examples-service.js.map

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

package/dist/tools/modExamples.d.ts

@@ -0,0 +1,144 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const MOD_EXAMPLES_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            mod: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            pattern_type: {
+                type: string;
+                description: string;
+            };
+            complexity: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            min_quality: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+            };
+            featured_only: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+            };
+            id?: undefined;
+            include_related?: undefined;
+            include_stats?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+            include_related: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            mod?: undefined;
+            category?: undefined;
+            pattern_type?: undefined;
+            complexity?: undefined;
+            min_quality?: undefined;
+            featured_only?: undefined;
+            limit?: undefined;
+            include_stats?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            include_stats: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            mod?: undefined;
+            category?: undefined;
+            pattern_type?: undefined;
+            complexity?: undefined;
+            min_quality?: undefined;
+            featured_only?: undefined;
+            limit?: undefined;
+            id?: undefined;
+            include_related?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query?: undefined;
+            mod?: undefined;
+            category?: undefined;
+            pattern_type?: undefined;
+            complexity?: undefined;
+            min_quality?: undefined;
+            featured_only?: undefined;
+            limit?: undefined;
+            id?: undefined;
+            include_related?: undefined;
+            include_stats?: undefined;
+        };
+        required?: undefined;
+    };
+})[];
+export interface SearchModExamplesParams {
+    query?: string;
+    mod?: string;
+    category?: string;
+    pattern_type?: string;
+    complexity?: string;
+    min_quality?: number;
+    featured_only?: boolean;
+    limit?: number;
+}
+export declare function handleSearchModExamples(params: SearchModExamplesParams): CallToolResult;
+export interface GetModExampleParams {
+    id: number;
+    include_related?: boolean;
+}
+export declare function handleGetModExample(params: GetModExampleParams): CallToolResult;
+export interface ListCanonicalModsParams {
+    include_stats?: boolean;
+}
+export declare function handleListCanonicalMods(params: ListCanonicalModsParams): CallToolResult;
+export declare function handleListModCategories(): CallToolResult;
+export declare function handleGetModPatterns(): CallToolResult;
+//# sourceMappingURL=modExamples.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modExamples.d.ts","sourceRoot":"","sources":["../../src/tools/modExamples.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAMzE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6H9B,CAAC;AAMF,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,cAAc,CAsEvF;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc,CA0E/E;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,cAAc,CAkEvF;AAED,wBAAgB,uBAAuB,IAAI,cAAc,CA+CxD;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CA+CrD"}