mcmodding-mcp 0.1.0 → 0.2.1

package/dist/index.js

@@ -7,128 +7,139 @@ import { handleGetMinecraftVersion } from './tools/getMinecraftVersion.js';
 import { handleSearchDocs } from './tools/searchDocs.js';
 import { handleExplainConcept } from './tools/explainConcept.js';
 import { DbVersioning } from './db-versioning.js';
+import { ModExamplesService } from './services/mod-examples-service.js';
+import { MOD_EXAMPLES_TOOLS, handleSearchModExamples, handleGetModExample, handleListCanonicalMods, handleListModCategories, handleGetModPatterns, } from './tools/modExamples.js';
+if (process.argv.includes('install')) {
+    const { runInstaller } = await import('./cli/install.js');
+    await runInstaller();
+    process.exit(0);
+}
 const server = new Server({
     name: 'mcmodding-mcp',
-    version: '0.1.0',
+    version: '0.1.1',
 }, {
     capabilities: {
         tools: {},
         resources: {},
     },
 });
-server.setRequestHandler(ListToolsRequestSchema, () => {
-    return {
-        tools: [
-            {
-                name: 'search_fabric_docs',
-                description: 'Search Fabric modding documentation for guides and API information. Use this when you need to find documentation about Fabric modding features, APIs, or tutorials.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        query: {
-                            type: 'string',
-                            description: "Search query (e.g., 'how to register items', 'mixin tutorial', 'networking'). Be specific for best results. Especially useful for finding guides and API references.",
-                        },
-                        category: {
-                            type: 'string',
-                            enum: [
-                                'getting-started',
-                                'items',
-                                'blocks',
-                                'entities',
-                                'rendering',
-                                'networking',
-                                'data-generation',
-                                'all',
-                            ],
-                            description: 'Documentation category to search within (default: all)',
-                            default: 'all',
-                        },
-                    },
-                    required: ['query'],
+const BASE_TOOLS = [
+    {
+        name: 'search_fabric_docs',
+        description: 'Search Fabric modding documentation for guides and API information. Use this when you need to find documentation about Fabric modding features, APIs, or tutorials.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: "Search query (e.g., 'how to register items', 'mixin tutorial', 'networking'). Be specific for best results. Especially useful for finding guides and API references.",
+                },
+                category: {
+                    type: 'string',
+                    enum: [
+                        'getting-started',
+                        'items',
+                        'blocks',
+                        'entities',
+                        'rendering',
+                        'networking',
+                        'data-generation',
+                        'all',
+                    ],
+                    description: 'Documentation category to search within (default: all)',
+                    default: 'all',
                 },
             },
-            {
-                name: 'get_example',
-                description: 'Get code examples for Minecraft modding topics. Returns complete, working code snippets with full context including explanations, source documentation, and metadata. Use this when you need concrete code examples for implementing features.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        topic: {
-                            type: 'string',
-                            description: "Topic or pattern to get examples for (e.g., 'register item', 'block entity', 'mixin', 'networking', 'custom armor'). Can be free-form text.",
-                        },
-                        language: {
-                            type: 'string',
-                            description: "Programming language (e.g., 'java', 'json', 'groovy')",
-                            default: 'java',
-                        },
-                        loader: {
-                            type: 'string',
-                            enum: ['fabric', 'neoforge', 'shared'],
-                            description: 'Mod loader to filter by',
-                        },
-                        minecraft_version: {
-                            type: 'string',
-                            description: "Target Minecraft version (e.g., '1.21.4', '1.21.10'). Latest: use 'latest'",
-                        },
-                        category: {
-                            type: 'string',
-                            enum: [
-                                'getting-started',
-                                'items',
-                                'blocks',
-                                'entities',
-                                'rendering',
-                                'networking',
-                                'data-generation',
-                                'commands',
-                                'sounds',
-                            ],
-                            description: 'Documentation category to filter by',
-                        },
-                        limit: {
-                            type: 'number',
-                            description: 'Maximum number of examples to return (1-10)',
-                            default: 5,
-                            minimum: 1,
-                            maximum: 10,
-                        },
-                    },
-                    required: ['topic'],
+            required: ['query'],
+        },
+    },
+    {
+        name: 'get_example',
+        description: 'Get code examples for Minecraft modding topics. Returns complete, working code snippets with full context including explanations, source documentation, and metadata. Use this when you need concrete code examples for implementing features.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                topic: {
+                    type: 'string',
+                    description: "Topic or pattern to get examples for (e.g., 'register item', 'block entity', 'mixin', 'networking', 'custom armor'). Can be free-form text.",
+                },
+                language: {
+                    type: 'string',
+                    description: "Programming language (e.g., 'java', 'json', 'groovy')",
+                    default: 'java',
+                },
+                loader: {
+                    type: 'string',
+                    enum: ['fabric', 'neoforge', 'shared'],
+                    description: 'Mod loader to filter by',
+                },
+                minecraft_version: {
+                    type: 'string',
+                    description: "Target Minecraft version (e.g., '1.21.4', '1.21.10'). Latest: use 'latest'",
+                },
+                category: {
+                    type: 'string',
+                    enum: [
+                        'getting-started',
+                        'items',
+                        'blocks',
+                        'entities',
+                        'rendering',
+                        'networking',
+                        'data-generation',
+                        'commands',
+                        'sounds',
+                    ],
+                    description: 'Documentation category to filter by',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of examples to return (1-10)',
+                    default: 5,
+                    minimum: 1,
+                    maximum: 10,
                 },
             },
-            {
-                name: 'explain_fabric_concept',
-                description: 'Get detailed explanation of a Fabric or Minecraft modding concept. Use this to understand fundamental concepts, terminology, or architectural patterns.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        concept: {
-                            type: 'string',
-                            description: "Concept to explain (e.g., 'mixins', 'registries', 'sided logic', 'fabric.mod.json', 'events')",
-                        },
-                    },
-                    required: ['concept'],
+            required: ['topic'],
+        },
+    },
+    {
+        name: 'explain_fabric_concept',
+        description: 'Get detailed explanation of a Fabric or Minecraft modding concept. Use this to understand fundamental concepts, terminology, or architectural patterns.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                concept: {
+                    type: 'string',
+                    description: "Concept to explain (e.g., 'mixins', 'registries', 'sided logic', 'fabric.mod.json', 'events')",
                 },
             },
-            {
-                name: 'get_minecraft_version',
-                description: 'Get Minecraft version information from the indexed documentation. Returns either the latest version or all available versions.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        type: {
-                            type: 'string',
-                            enum: ['latest', 'all'],
-                            description: "Type of version info: 'latest' for newest version, 'all' for complete list",
-                            default: 'latest',
-                        },
-                    },
+            required: ['concept'],
+        },
+    },
+    {
+        name: 'get_minecraft_version',
+        description: 'Get Minecraft version information from the indexed documentation. Returns either the latest version or all available versions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    enum: ['latest', 'all'],
+                    description: "Type of version info: 'latest' for newest version, 'all' for complete list",
+                    default: 'latest',
                 },
             },
-        ],
-    };
+        },
+    },
+];
+server.setRequestHandler(ListToolsRequestSchema, () => {
+    const tools = [...BASE_TOOLS];
+    if (ModExamplesService.isAvailable()) {
+        tools.push(...MOD_EXAMPLES_TOOLS);
+        console.error('[MCP] Mod examples database available - additional tools registered');
+    }
+    return { tools };
 });
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
@@ -163,6 +174,35 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 type: args?.type || 'latest',
             });
         }
+        case 'search_mod_examples': {
+            return handleSearchModExamples({
+                query: args?.query,
+                mod: args?.mod,
+                category: args?.category,
+                pattern_type: args?.pattern_type,
+                complexity: args?.complexity,
+                min_quality: args?.min_quality,
+                featured_only: args?.featured_only,
+                limit: args?.limit,
+            });
+        }
+        case 'get_mod_example': {
+            return handleGetModExample({
+                id: args?.id || 0,
+                include_related: args?.include_related,
+            });
+        }
+        case 'list_canonical_mods': {
+            return handleListCanonicalMods({
+                include_stats: args?.include_stats,
+            });
+        }
+        case 'list_mod_categories': {
+            return handleListModCategories();
+        }
+        case 'get_mod_patterns': {
+            return handleGetModPatterns();
+        }
         default:
             throw new Error(`Unknown tool: ${name}`);
     }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;KACd;CACF,CACF,CAAC;AAGF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpD,OAAO;QACL,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EACT,qKAAqK;gBACvK,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EACT,sKAAsK;yBACzK;wBACD,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE;gCACJ,iBAAiB;gCACjB,OAAO;gCACP,QAAQ;gCACR,UAAU;gCACV,WAAW;gCACX,YAAY;gCACZ,iBAAiB;gCACjB,KAAK;6BACN;4BACD,WAAW,EAAE,wDAAwD;4BACrE,OAAO,EAAE,KAAK;yBACf;qBACF;oBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;iBACpB;aACF;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,WAAW,EACT,gPAAgP;gBAClP,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EACT,6IAA6I;yBAChJ;wBACD,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,uDAAuD;4BACpE,OAAO,EAAE,MAAM;yBAChB;wBACD,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC;4BACtC,WAAW,EAAE,yBAAyB;yBACvC;wBACD,iBAAiB,EAAE;4BACjB,IAAI,EAAE,QAAQ;4BACd,WAAW,EACT,4EAA4E;yBAC/E;wBACD,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE;gCACJ,iBAAiB;gCACjB,OAAO;gCACP,QAAQ;gCACR,UAAU;gCACV,WAAW;gCACX,YAAY;gCACZ,iBAAiB;gCACjB,UAAU;gCACV,QAAQ;6BACT;4BACD,WAAW,EAAE,qCAAqC;yBACnD;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,6CAA6C;4BAC1D,OAAO,EAAE,CAAC;4BACV,OAAO,EAAE,CAAC;4BACV,OAAO,EAAE,EAAE;yBACZ;qBACF;oBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;iBACpB;aACF;YACD;gBACE,IAAI,EAAE,wBAAwB;gBAC9B,WAAW,EACT,yJAAyJ;gBAC3J,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EACT,+FAA+F;yBAClG;qBACF;oBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;iBACtB;aACF;YACD;gBACE,IAAI,EAAE,uBAAuB;gBAC7B,WAAW,EACT,gIAAgI;gBAClI,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;4BACvB,WAAW,EACT,4EAA4E;4BAC9E,OAAO,EAAE,QAAQ;yBAClB;qBACF;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAGH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,OAAO,gBAAgB,CAAC;gBACtB,KAAK,EAAG,IAAI,EAAE,KAAgB,IAAI,EAAE;gBACpC,QAAQ,EAAE,IAAI,EAAE,QAA8B;gBAC9C,MAAM,EAAE,IAAI,EAAE,MAA4B;gBAC1C,gBAAgB,EAAE,IAAI,EAAE,iBAAuC;gBAC/D,WAAW,EAAE,IAAI,EAAE,YAAmC;gBACtD,KAAK,EAAE,IAAI,EAAE,KAA2B;aACzC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,OAAO,gBAAgB,CAAC;gBACtB,KAAK,EAAG,IAAI,EAAE,KAAgB,IAAI,EAAE;gBACpC,QAAQ,EAAE,IAAI,EAAE,QAA8B;gBAC9C,MAAM,EAAE,IAAI,EAAE,MAA4B;gBAC1C,gBAAgB,EAAE,IAAI,EAAE,iBAAuC;gBAC/D,QAAQ,EAAE,IAAI,EAAE,QAA8B;gBAC9C,KAAK,EAAE,IAAI,EAAE,KAA2B;aACzC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,OAAO,MAAM,oBAAoB,CAAC;gBAChC,OAAO,EAAG,IAAI,EAAE,OAAkB,IAAI,EAAE;aACzC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,OAAO,yBAAyB,CAAC;gBAC/B,IAAI,EAAG,IAAI,EAAE,IAAyB,IAAI,QAAQ;aACnD,CAAC,CAAC;QACL,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC,CAAC,CAAC;AAGH,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxD,OAAO;QACL,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC,CAAC,CAAC;AAGH,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,CAAC,OAAO,EAAE,EAAE;IAC9D,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAGH,KAAK,UAAU,IAAI;IAEjB,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,IAAI,YAAY,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;QAC9C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;IAErE,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACjE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/services/mod-examples-service.d.ts

@@ -0,0 +1,106 @@
+export interface ModInfo {
+    id: number;
+    name: string;
+    repo: string;
+    loader: string;
+    description: string;
+    readmeSummary: string;
+    architectureNotes: string;
+    starCount: number;
+    minecraftVersions: string[];
+    exampleCount: number;
+}
+export interface ModExample {
+    id: number;
+    modName: string;
+    modRepo: string;
+    filePath: string;
+    fileUrl: string;
+    startLine: number;
+    endLine: number;
+    title: string;
+    code: string;
+    language: string;
+    caption: string;
+    explanation: string;
+    patternType: string;
+    complexity: 'beginner' | 'intermediate' | 'advanced' | 'expert';
+    category: string;
+    categoryName: string;
+    bestPractices: string[];
+    potentialPitfalls: string[];
+    useCases: string[];
+    keywords: string[];
+    minecraftConcepts: string[];
+    qualityScore: number;
+    isFeatured: boolean;
+    tags: string[];
+    imports: Array<{
+        path: string;
+        type: string;
+        isCritical: boolean;
+    }>;
+    apiReferences: Array<{
+        className: string;
+        methodName?: string;
+        apiType: string;
+    }>;
+}
+export interface ExampleRelation {
+    sourceId: number;
+    targetId: number;
+    relationType: 'uses' | 'extends' | 'similar_to' | 'alternative_to' | 'requires' | 'complements';
+    description: string;
+    strength: number;
+    targetTitle: string;
+    targetCaption: string;
+}
+export interface ModExampleSearchOptions {
+    query?: string;
+    modName?: string;
+    category?: string;
+    patternType?: string;
+    complexity?: string;
+    minQualityScore?: number;
+    featured?: boolean;
+    tags?: string[];
+    limit?: number;
+}
+export interface CategoryInfo {
+    slug: string;
+    name: string;
+    description: string;
+    icon: string;
+    exampleCount: number;
+}
+export declare class ModExamplesService {
+    private db;
+    private static dbPath;
+    constructor(dbPath?: string);
+    static isAvailable(): boolean;
+    getStats(): {
+        mods: number;
+        examples: number;
+        relations: number;
+        categories: number;
+        featuredExamples: number;
+        avgQualityScore: number;
+    };
+    listMods(): ModInfo[];
+    getMod(name: string): ModInfo | null;
+    listCategories(): CategoryInfo[];
+    searchExamples(options: ModExampleSearchOptions): ModExample[];
+    getExample(id: number): ModExample | null;
+    getRelatedExamples(exampleId: number): ExampleRelation[];
+    getFeaturedExamples(limit?: number): ModExample[];
+    getExamplesByPattern(patternType: string, limit?: number): ModExample[];
+    getPatternTypes(): Array<{
+        type: string;
+        count: number;
+    }>;
+    private enrichExample;
+    formatExampleForAI(example: ModExample): string;
+    formatExamplesForAI(examples: ModExample[]): string;
+    close(): void;
+}
+//# sourceMappingURL=mod-examples-service.d.ts.map

package/dist/services/mod-examples-service.d.ts.map

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