mcmodding-mcp 0.1.0 → 0.2.2

package/dist/tools/modExamples.js

@@ -0,0 +1,402 @@
+import { ModExamplesService } from '../services/mod-examples-service.js';
+export const MOD_EXAMPLES_TOOLS = [
+    {
+        name: 'search_mod_examples',
+        description: 'Search through canonical code examples from popular open-source mods like Create, Botania, Applied Energistics 2. These are real-world, battle-tested implementations with AI-generated explanations. Use this when you need proven patterns from successful mods.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query (e.g., "block entity", "custom renderer", "networking", "registration"). Free-form text search.',
+                },
+                mod: {
+                    type: 'string',
+                    description: 'Filter by specific mod name (e.g., "Create", "Botania", "Applied Energistics 2", "Fabric API")',
+                },
+                category: {
+                    type: 'string',
+                    enum: [
+                        'blocks',
+                        'items',
+                        'entities',
+                        'tile-entities',
+                        'rendering',
+                        'gui',
+                        'networking',
+                        'worldgen',
+                        'data-generation',
+                        'recipes',
+                        'events',
+                        'registry',
+                        'api-design',
+                        'cross-platform',
+                        'storage-systems',
+                        'animation',
+                        'particles',
+                        'sounds',
+                        'commands',
+                        'config',
+                    ],
+                    description: 'Filter by pattern category',
+                },
+                pattern_type: {
+                    type: 'string',
+                    description: 'Filter by pattern type (e.g., "block-registration", "event-handler", "renderer", "packet-handler")',
+                },
+                complexity: {
+                    type: 'string',
+                    enum: ['beginner', 'intermediate', 'advanced', 'expert'],
+                    description: 'Filter by complexity level',
+                },
+                min_quality: {
+                    type: 'number',
+                    description: 'Minimum quality score (0.0-1.0). Higher = more curated examples. Default: 0.5',
+                    minimum: 0,
+                    maximum: 1,
+                },
+                featured_only: {
+                    type: 'boolean',
+                    description: 'Only return featured (highest quality) examples',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum results (1-20). Default: 5',
+                    minimum: 1,
+                    maximum: 20,
+                },
+            },
+        },
+    },
+    {
+        name: 'get_mod_example',
+        description: 'Get detailed information about a specific mod example by ID. Returns full code, explanation, best practices, pitfalls, imports, and related examples. Use after searching to get complete details.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'number',
+                    description: 'Example ID (from search results)',
+                },
+                include_related: {
+                    type: 'boolean',
+                    description: 'Include related examples (similar patterns, dependencies). Default: true',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'list_canonical_mods',
+        description: 'List all indexed canonical mods with their example counts and descriptions. Use this to discover what mods are available for examples.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                include_stats: {
+                    type: 'boolean',
+                    description: 'Include database statistics. Default: false',
+                },
+            },
+        },
+    },
+    {
+        name: 'list_mod_categories',
+        description: 'List all available pattern categories with example counts. Use this to discover what types of examples are available.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'get_mod_patterns',
+        description: 'Get all available pattern types with counts. Useful for discovering specific implementation patterns.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+export function handleSearchModExamples(params) {
+    try {
+        if (!ModExamplesService.isAvailable()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Mod examples database is not available. This is an optional feature that provides examples from canonical open-source mods.\n\nThe standard documentation tools (search_fabric_docs, get_example) are still available.',
+                    },
+                ],
+            };
+        }
+        const service = new ModExamplesService();
+        try {
+            const examples = service.searchExamples({
+                query: params.query,
+                modName: params.mod,
+                category: params.category,
+                patternType: params.pattern_type,
+                complexity: params.complexity,
+                minQualityScore: params.min_quality ?? 0.5,
+                featured: params.featured_only,
+                limit: Math.min(Math.max(params.limit || 5, 1), 20),
+            });
+            let output = '';
+            if (examples.length === 0) {
+                output = 'No mod examples found matching your criteria.\n\n';
+                output += '**Suggestions:**\n';
+                output += '- Try broader search terms\n';
+                output += '- Remove category or complexity filters\n';
+                output += '- Use `list_canonical_mods` to see available mods\n';
+                output += '- Use `list_mod_categories` to see available categories\n';
+            }
+            else {
+                output = `Found ${examples.length} canonical mod example${examples.length > 1 ? 's' : ''}:\n\n`;
+                examples.forEach((ex, i) => {
+                    output += `### ${i + 1}. ${ex.title}\n`;
+                    output += `**ID:** ${ex.id} | **Mod:** ${ex.modName} | **Quality:** ${(ex.qualityScore * 100).toFixed(0)}%`;
+                    if (ex.isFeatured)
+                        output += ' | ⭐ Featured';
+                    output += '\n';
+                    output += `**Category:** ${ex.categoryName || ex.category} | **Pattern:** ${ex.patternType} | **Complexity:** ${ex.complexity}\n`;
+                    output += `\n${ex.caption}\n\n`;
+                    output += `\`\`\`${ex.language}\n${ex.code.slice(0, 500)}${ex.code.length > 500 ? '\n// ... (truncated, use get_mod_example for full code)' : ''}\n\`\`\`\n\n`;
+                    output += `→ Use \`get_mod_example\` with ID ${ex.id} for full details\n\n---\n\n`;
+                });
+            }
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        finally {
+            service.close();
+        }
+    }
+    catch (error) {
+        console.error('[search_mod_examples] Error:', error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error searching mod examples: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+export function handleGetModExample(params) {
+    try {
+        if (!ModExamplesService.isAvailable()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Mod examples database is not available.',
+                    },
+                ],
+            };
+        }
+        const service = new ModExamplesService();
+        try {
+            const example = service.getExample(params.id);
+            if (!example) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Example with ID ${params.id} not found. Use search_mod_examples to find valid example IDs.`,
+                        },
+                    ],
+                };
+            }
+            let output = service.formatExampleForAI(example);
+            if (params.include_related !== false) {
+                const relations = service.getRelatedExamples(params.id);
+                if (relations.length > 0) {
+                    output += '\n---\n\n## Related Examples\n\n';
+                    relations.forEach((rel) => {
+                        const relationLabel = {
+                            uses: '📦 Uses',
+                            extends: '🔄 Extends',
+                            similar_to: '🔗 Similar to',
+                            alternative_to: '↔️ Alternative to',
+                            requires: '⚠️ Requires',
+                            complements: '✨ Complements',
+                        }[rel.relationType] || rel.relationType;
+                        output += `**${relationLabel}** (ID: ${rel.targetId}, strength: ${(rel.strength * 100).toFixed(0)}%)\n`;
+                        output += `- ${rel.targetTitle}\n`;
+                        output += `- ${rel.description}\n\n`;
+                    });
+                }
+            }
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        finally {
+            service.close();
+        }
+    }
+    catch (error) {
+        console.error('[get_mod_example] Error:', error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error retrieving example: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+export function handleListCanonicalMods(params) {
+    try {
+        if (!ModExamplesService.isAvailable()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Mod examples database is not available.',
+                    },
+                ],
+            };
+        }
+        const service = new ModExamplesService();
+        try {
+            const mods = service.listMods();
+            let output = '# Indexed Canonical Mods\n\n';
+            output += 'These are high-quality, open-source mods with AI-analyzed code examples:\n\n';
+            if (params.include_stats) {
+                const stats = service.getStats();
+                output += '## Database Statistics\n\n';
+                output += `| Metric | Value |\n`;
+                output += `|--------|-------|\n`;
+                output += `| Total Mods | ${stats.mods} |\n`;
+                output += `| Total Examples | ${stats.examples} |\n`;
+                output += `| Relationships | ${stats.relations} |\n`;
+                output += `| Featured Examples | ${stats.featuredExamples} |\n`;
+                output += `| Avg Quality Score | ${(stats.avgQualityScore * 100).toFixed(0)}% |\n\n`;
+            }
+            output += '## Available Mods\n\n';
+            mods.forEach((mod) => {
+                output += `### ${mod.name}\n`;
+                output += `**Repository:** [${mod.repo}](https://github.com/${mod.repo})\n`;
+                output += `**Loader:** ${mod.loader} | **Stars:** ${mod.starCount.toLocaleString()} | **Examples:** ${mod.exampleCount}\n`;
+                output += `**Versions:** ${mod.minecraftVersions.join(', ') || 'Various'}\n\n`;
+                output += `${mod.description}\n\n`;
+                if (mod.architectureNotes) {
+                    output += `*Architecture:* ${mod.architectureNotes.slice(0, 200)}${mod.architectureNotes.length > 200 ? '...' : ''}\n\n`;
+                }
+                output += '---\n\n';
+            });
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        finally {
+            service.close();
+        }
+    }
+    catch (error) {
+        console.error('[list_canonical_mods] Error:', error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error listing mods: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+export function handleListModCategories() {
+    try {
+        if (!ModExamplesService.isAvailable()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Mod examples database is not available.',
+                    },
+                ],
+            };
+        }
+        const service = new ModExamplesService();
+        try {
+            const categories = service.listCategories();
+            let output = '# Pattern Categories\n\n';
+            output += 'Available categories for filtering mod examples:\n\n';
+            output += '| Category | Name | Examples | Description |\n';
+            output += '|----------|------|----------|-------------|\n';
+            categories.forEach((cat) => {
+                output += `| ${cat.icon} \`${cat.slug}\` | ${cat.name} | ${cat.exampleCount} | ${cat.description} |\n`;
+            });
+            output += '\n**Usage:** `search_mod_examples` with `category` parameter\n';
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        finally {
+            service.close();
+        }
+    }
+    catch (error) {
+        console.error('[list_mod_categories] Error:', error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error listing categories: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+export function handleGetModPatterns() {
+    try {
+        if (!ModExamplesService.isAvailable()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Mod examples database is not available.',
+                    },
+                ],
+            };
+        }
+        const service = new ModExamplesService();
+        try {
+            const patterns = service.getPatternTypes();
+            let output = '# Pattern Types\n\n';
+            output += 'Specific implementation patterns found in indexed mods:\n\n';
+            output += '| Pattern Type | Example Count |\n';
+            output += '|--------------|---------------|\n';
+            patterns.forEach((p) => {
+                output += `| \`${p.type}\` | ${p.count} |\n`;
+            });
+            output += '\n**Usage:** `search_mod_examples` with `pattern_type` parameter\n';
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        finally {
+            service.close();
+        }
+    }
+    catch (error) {
+        console.error('[get_mod_patterns] Error:', error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error getting patterns: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=modExamples.js.map

package/dist/tools/modExamples.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcmodding-mcp",
-  "version": "0.1.0",
+  "version": "0.2.2",
   "description": "MCP server providing AI assistants with up-to-date Minecraft modding documentation for Fabric and NeoForge",
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,7 @@
   ],
   "scripts": {
     "build": "tsc",
-    "build:prod": "npm run index-docs:prod && npm run build",
+    "build:prod": "npm run build",
     "dev": "tsx watch src/index.ts",
     "start": "node dist/index.js",
     "test": "vitest",
@@ -31,7 +31,7 @@
     "clean": "rimraf dist",
     "clean:all": "rimraf dist data",
     "prebuild": "npm run clean",
-    "prebuild:prod": "npm run clean:all",
+    "prebuild:prod": "npm run clean",
     "postinstall": "node scripts/postinstall.js",
     "prepublishOnly": "",
     "release:auto": "semantic-release",
@@ -68,6 +68,7 @@
     "@commitlint/config-conventional": "^19.6.0",
     "@eslint/js": "^9.15.0",
     "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
     "@types/better-sqlite3": "^7.6.12",
     "@types/jquery": "^3.5.33",
@@ -76,6 +77,7 @@
     "@typescript-eslint/parser": "^8.15.0",
     "@vitest/coverage-v8": "^4.0.15",
     "@vitest/ui": "^4.0.15",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
     "eslint": "^9.15.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-prettier": "^5.2.1",
@@ -83,7 +85,7 @@
     "lint-staged": "^15.2.11",
     "prettier": "^3.3.3",
     "rimraf": "^6.0.1",
-    "semantic-release": "^21.1.2",
+    "semantic-release": "^24.2.3",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "typescript-eslint": "^8.15.0",

package/scripts/postinstall.js

@@ -23,7 +23,7 @@ const CONFIG = {
   repoUrl: 'https://api.github.com/repos/OGMatrix/mcmodding-mcp/releases/latest',
   dataDir: path.join(__dirname, '..', 'data'),
   dbFileName: 'mcmodding-docs.db',
-  manifestFileName: 'manifest.json',
+  manifestFileName: 'db-manifest.json',
   userAgent: 'mcmodding-mcp-installer',
 };
 
@@ -260,8 +260,9 @@ function printSectionFooter() {
 }
 
 function createProgressBar(progress, width = 40, showGradient = true) {
-  const filled = Math.round(progress * width);
-  const empty = width - filled;
+  const clampedProgress = Math.min(Math.max(progress, 0), 1);
+  const filled = Math.round(clampedProgress * width);
+  const empty = Math.max(0, width - filled);
 
   let bar = '';
   if (showGradient && isColorSupported) {
@@ -577,6 +578,8 @@ async function downloadWithProgress(url, destPath, onProgress) {
   return new Promise((resolve, reject) => {
     const file = fs.createWriteStream(destPath);
 
+    console.log(`  ${c.dim}${sym.arrow} Downloading from: ${url}${c.reset}`);
+
     const makeRequest = (requestUrl) => {
       const urlObj = new URL(requestUrl);
       const options = {
@@ -772,6 +775,7 @@ async function main() {
       });
       progress.finish(true, 'Download complete!');
     } catch (error) {
+      console.error(error);
       progress.finish(false, `Download failed: ${error.message}`);
       if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath);
       console.log();