mcmodding-mcp 0.1.0

package/dist/tools/searchDocs.js

@@ -0,0 +1,144 @@
+import { SearchService } from '../services/search-service.js';
+let searchServiceInstance = null;
+function getSearchService() {
+    if (!searchServiceInstance) {
+        searchServiceInstance = new SearchService();
+    }
+    return searchServiceInstance;
+}
+export async function handleSearchDocs(params) {
+    const { query, category, loader, minecraftVersion, includeCode = true, limit = 10 } = params;
+    if (!query || typeof query !== 'string' || query.trim().length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Error: Query parameter is required and cannot be empty.',
+                },
+            ],
+            isError: true,
+        };
+    }
+    const trimmedQuery = query.trim();
+    const effectiveLimit = Math.min(Math.max(1, limit), 20);
+    try {
+        const searchService = getSearchService();
+        const searchOptions = {
+            query: trimmedQuery,
+            limit: effectiveLimit,
+            includeCode,
+        };
+        if (category && category !== 'all') {
+            searchOptions.category = category;
+        }
+        if (loader) {
+            searchOptions.loader = loader;
+        }
+        if (minecraftVersion) {
+            if (minecraftVersion.toLowerCase() === 'latest') {
+                const stats = searchService.getStats();
+                const versions = stats.versions.sort((a, b) => {
+                    const partsA = a.split('.').map(Number);
+                    const partsB = b.split('.').map(Number);
+                    for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
+                        const numA = partsA[i] || 0;
+                        const numB = partsB[i] || 0;
+                        if (numA !== numB)
+                            return numB - numA;
+                    }
+                    return 0;
+                });
+                if (versions[0]) {
+                    searchOptions.minecraftVersion = versions[0];
+                }
+            }
+            else {
+                searchOptions.minecraftVersion = minecraftVersion;
+            }
+        }
+        const results = await searchService.search(searchOptions);
+        const formattedOutput = searchService.formatForAI(results, trimmedQuery);
+        const metadata = buildMetadata(results, searchOptions, searchService);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: formattedOutput + '\n\n' + metadata,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`[searchDocs] Error: ${errorMessage}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error searching documentation: ${errorMessage}\n\nPlease ensure the documentation database has been indexed. Run 'npm run index' to build the database.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+function buildMetadata(results, options, service) {
+    const stats = service.getStats();
+    let metadata = '---\n**Search Metadata:**\n';
+    metadata += `- Query: "${options.query}"\n`;
+    metadata += `- Results found: ${results.length}\n`;
+    if (options.category) {
+        metadata += `- Category filter: ${options.category}\n`;
+    }
+    if (options.loader) {
+        metadata += `- Loader filter: ${options.loader}\n`;
+    }
+    if (options.minecraftVersion) {
+        metadata += `- Minecraft version filter: ${options.minecraftVersion}\n`;
+    }
+    metadata += `\n**Database Stats:**\n`;
+    metadata += `- Total documents indexed: ${stats.totalDocuments}\n`;
+    metadata += `- Total sections: ${stats.totalSections}\n`;
+    metadata += `- Available loaders: ${stats.loaders.join(', ')}\n`;
+    metadata += `- Available versions: ${stats.versions.slice(0, 5).join(', ')}${stats.versions.length > 5 ? '...' : ''}\n`;
+    if (results.length === 0) {
+        metadata += '\n**Suggestions:**\n';
+        metadata += '- Try broader search terms\n';
+        metadata += '- Remove category/loader filters\n';
+        metadata += '- Use synonyms (e.g., "register" instead of "create")\n';
+    }
+    else if (results.length < 3) {
+        metadata += '\n**Note:** Few results found. Consider:\n';
+        metadata += '- Using `get_example` for specific code examples\n';
+        metadata += '- Trying related terms or concepts\n';
+    }
+    return metadata;
+}
+export async function searchDocs(params) {
+    const searchService = getSearchService();
+    return await searchService.search({
+        query: params.query,
+        category: params.category,
+        minecraftVersion: params.minecraftVersion,
+        limit: 10,
+    });
+}
+export function getAvailableCategories() {
+    return [
+        'getting-started',
+        'items',
+        'blocks',
+        'entities',
+        'rendering',
+        'networking',
+        'data-generation',
+        'commands',
+        'sounds',
+        'events',
+        'mixins',
+    ];
+}
+export function getAvailableLoaders() {
+    return ['fabric', 'neoforge', 'shared'];
+}
+//# sourceMappingURL=searchDocs.js.map

package/dist/tools/searchDocs.js.map

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

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "mcmodding-mcp",
+  "version": "0.1.0",
+  "description": "MCP server providing AI assistants with up-to-date Minecraft modding documentation for Fabric and NeoForge",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcmodding-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scripts/postinstall.js"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:prod": "npm run index-docs:prod && npm run build",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "test:ui": "vitest --ui",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "prepare": "husky",
+    "index-docs": "npx tsx --expose-gc --max-old-space-size=6144 scripts/index-docs.ts -- --sitemap --embeddings",
+    "index-docs:prod": "npx tsx --expose-gc --max-old-space-size=6144 scripts/index-docs.ts -- --sitemap --embeddings --force",
+    "index-docs:no-embeddings": "npx tsx --expose-gc --max-old-space-size=4096 scripts/index-docs.ts -- --sitemap",
+    "clean": "rimraf dist",
+    "clean:all": "rimraf dist data",
+    "prebuild": "npm run clean",
+    "prebuild:prod": "npm run clean:all",
+    "postinstall": "node scripts/postinstall.js",
+    "prepublishOnly": "",
+    "release:auto": "semantic-release",
+    "release": "npm run build:prod && npm version",
+    "validate": "npm run typecheck && npm run lint && npm run test",
+    "db:manifest": "npx tsx scripts/generate-db-manifest.ts",
+    "db:install-optional": "npx tsx src/index.ts install"
+  },
+  "keywords": [
+    "minecraft",
+    "modding",
+    "fabric",
+    "neoforge",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "documentation"
+  ],
+  "author": "OGMatrix",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@xenova/transformers": "^2.17.2",
+    "better-sqlite3": "^11.7.0",
+    "cheerio": "^1.0.0",
+    "jsonrepair": "^3.13.1",
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.6.0",
+    "@commitlint/config-conventional": "^19.6.0",
+    "@eslint/js": "^9.15.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/jquery": "^3.5.33",
+    "@types/node": "^22.10.1",
+    "@typescript-eslint/eslint-plugin": "^8.15.0",
+    "@typescript-eslint/parser": "^8.15.0",
+    "@vitest/coverage-v8": "^4.0.15",
+    "@vitest/ui": "^4.0.15",
+    "eslint": "^9.15.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.2.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.2.11",
+    "prettier": "^3.3.3",
+    "rimraf": "^6.0.1",
+    "semantic-release": "^21.1.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.15.0",
+    "vitest": "^4.0.15"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OGMatrix/mcmodding-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/OGMatrix/mcmodding-mcp/issues"
+  },
+  "homepage": "https://github.com/OGMatrix/mcmodding-mcp#readme"
+}