@creeperhost/modlens-mcp 1.6.0

package/dist/modpacks-ch.js

@@ -0,0 +1,146 @@
+/**
+ * modpacks.ch public API client.
+ *
+ * modpacks.ch is a service by CreeperHost (https://www.creeperhost.net).
+ * The API is freely accessible — no auth required.
+ * The modpacks.ch team requested a custom User-Agent for usage tracking.
+ */
+import { fetchWithRetry, DOWNLOAD_OPTS } from "./fetch-utils.js";
+import { createWriteStream } from "fs";
+import { pipeline } from "stream/promises";
+export const FTBAPI = "https://api.modpacks.ch/public";
+/** User-Agent as requested by the modpacks.ch (CreeperHost) team for usage tracking. */
+export const USER_AGENT = "modlens-mcp/1.0 (github.com/CreeperHost/modlens-mcp)";
+const HEADERS = { "User-Agent": USER_AGENT };
+// ── API helpers ───────────────────────────────────────────────────────────────
+async function get(path) {
+    const res = await fetchWithRetry(`${FTBAPI}/${path}`, { headers: HEADERS });
+    if (res.status === 404)
+        return null;
+    if (!res.ok)
+        throw new Error(`modpacks.ch API ${res.status} for /${path}`);
+    const text = await res.text();
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error(`modpacks.ch returned non-JSON for /${path}: ${text.slice(0, 200)}`);
+    }
+}
+// ── Mod API ───────────────────────────────────────────────────────────────────
+export async function searchMods(term, limit = 20) {
+    return get(`mod/search/${limit}?term=${encodeURIComponent(term)}`);
+}
+export async function getMod(id) {
+    return get(`mod/${id}`);
+}
+/**
+ * Batch-fetch multiple mods by their IDs. Useful after a search to enrich
+ * result IDs into full mod objects. Runs requests in parallel.
+ */
+export async function getModsBatch(ids) {
+    const results = await Promise.allSettled(ids.map((id) => getMod(id)));
+    return results
+        .filter((r) => r.status === "fulfilled" && r.value !== null)
+        .map((r) => r.value);
+}
+/**
+ * Resolve the download URL for a mod version.
+ * Some entries have url="" — in that case the CDN URL is constructed from
+ * the file ID using the same cfCdnUrl pattern as pack manifests.
+ */
+export function resolveModVersionUrl(version) {
+    if (version.url)
+        return version.url;
+    if (version.id)
+        return cfCdnUrl(version.id, version.name);
+    if (version.mirrors?.length)
+        return version.mirrors[0];
+    return null;
+}
+// ── Modpack API (FTB namespace) ───────────────────────────────────────────────
+export async function searchPacks(term, limit = 20) {
+    return get(`modpack/search/${limit}?term=${encodeURIComponent(term)}`);
+}
+export async function getFeaturedPacks(limit = 20) {
+    return get(`modpack/featured/${limit}`);
+}
+export async function getPack(packId) {
+    return get(`modpack/${packId}`);
+}
+export async function getPackManifest(packId, versionId) {
+    return get(`modpack/${packId}/${versionId}`);
+}
+// ── CurseForge modpack API (no CF API key required) ───────────────────────────
+// Mirrors the /modpack/ namespace but for CurseForge-hosted packs.
+// provider field will be "curseforge" in all responses.
+/**
+ * Search CurseForge packs via the unified FTB search endpoint.
+ * The /curseforge/search/ endpoint does NOT exist — CF packs are returned
+ * in the `curseforge` array of the main /modpack/search/ response.
+ */
+export async function searchCfPacks(term, limit = 20) {
+    return searchPacks(term, limit);
+}
+export async function getCfPack(packId) {
+    return get(`curseforge/${packId}`);
+}
+export async function getCfPackManifest(packId, versionId) {
+    return get(`curseforge/${packId}/${versionId}`);
+}
+/**
+ * Build a direct CurseForge CDN download URL for a manifest file whose `url`
+ * is empty (CF packs return url: "" for mod-type files).
+ *
+ * Pattern: https://edge.forgecdn.net/files/{fileId÷1000}/{fileId%1000}/{name}
+ */
+export function cfCdnUrl(fileId, filename) {
+    const hi = Math.floor(fileId / 1000);
+    const lo = fileId % 1000;
+    return `https://edge.forgecdn.net/files/${hi}/${lo}/${encodeURIComponent(filename)}`;
+}
+/**
+ * Resolve the download URL for any manifest file, regardless of whether it
+ * comes from an FTB pack (direct URL) or a CurseForge pack (empty url →
+ * reconstruct from the embedded curseforge metadata).
+ *
+ * Returns null if the file type is not downloadable (e.g. "cf-extract"
+ * overrides ZIPs that have their own url should still be fine, this only
+ * returns null if there is genuinely no URL to construct).
+ */
+export function resolveFileUrl(file) {
+    if (file.url)
+        return file.url;
+    if (file.curseforge)
+        return cfCdnUrl(file.curseforge.file, file.name);
+    if (file.mirror)
+        return file.mirror;
+    // cf-extract overrides ZIPs use the version ID as their file ID
+    if (file.type === "cf-extract" && file.id)
+        return cfCdnUrl(file.id, file.name);
+    return null;
+}
+// ── File download ─────────────────────────────────────────────────────────────
+/**
+ * Download a single FTB/CF manifest file to a local destination path.
+ * Handles both FTB packs (direct CDN `url`) and CurseForge packs (empty `url`
+ * → reconstruct via cfCdnUrl from embedded curseforge metadata).
+ */
+export async function downloadManifestFile(file, destPath) {
+    const primary = resolveFileUrl(file);
+    if (!primary)
+        throw new Error(`No download URL for file ${file.name} (id ${file.id})`);
+    const attempt = async (url) => {
+        const res = await fetchWithRetry(url, { headers: HEADERS }, DOWNLOAD_OPTS);
+        return res;
+    };
+    let res = await attempt(primary);
+    if (!res.ok && file.mirror && file.mirror !== primary) {
+        res = await attempt(file.mirror);
+    }
+    if (!res.ok)
+        throw new Error(`Failed to download ${file.name}: HTTP ${res.status} from ${primary}`);
+    const writer = createWriteStream(destPath);
+    await pipeline(res.body, writer);
+}
+//# sourceMappingURL=modpacks-ch.js.map

package/dist/modpacks-ch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modpacks-ch.js","sourceRoot":"","sources":["../src/modpacks-ch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,CAAC,MAAM,MAAM,GAAG,gCAAgC,CAAC;AAEvD,wFAAwF;AACxF,MAAM,CAAC,MAAM,UAAU,GAAG,sDAAsD,CAAC;AACjF,MAAM,OAAO,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AAoL7C,iFAAiF;AAEjF,KAAK,UAAU,GAAG,CAAI,IAAY;IAC9B,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5E,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,SAAS,IAAI,EAAE,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACL,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;AACL,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,KAAK,GAAG,EAAE;IACrD,OAAO,GAAG,CAAqB,cAAc,KAAK,SAAS,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EAAmB;IAC5C,OAAO,GAAG,CAAS,OAAO,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAwB;IACvD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,OAAO;SACT,MAAM,CAAC,CAAC,CAAC,EAAuC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC;SAChG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAsB;IACvD,IAAI,OAAO,CAAC,GAAG;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IACpC,IAAI,OAAO,CAAC,EAAE;QAAG,OAAO,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,KAAK,GAAG,EAAE;IACtD,OAAO,GAAG,CAAsB,kBAAkB,KAAK,SAAS,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAK,GAAG,EAAE;IAC7C,OAAO,GAAG,CAAqC,oBAAoB,KAAK,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc;IACxC,OAAO,GAAG,CAAU,WAAW,MAAM,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,SAAiB;IACnE,OAAO,GAAG,CAAc,WAAW,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,iFAAiF;AACjF,mEAAmE;AACnE,wDAAwD;AAExD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,KAAK,GAAG,EAAE;IACxD,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc;IAC1C,OAAO,GAAG,CAAU,cAAc,MAAM,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAc,EAAE,SAAiB;IACrE,OAAO,GAAG,CAAc,cAAc,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,QAAgB;IACrD,MAAM,EAAE,GAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,EAAE,GAAI,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,mCAAmC,EAAE,IAAI,EAAE,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;AACzF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,IAAqB;IAChD,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC;IAC9B,IAAI,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,IAAI,IAAI,CAAC,MAAM;QAAM,OAAO,IAAI,CAAC,MAAM,CAAC;IACxC,gEAAgE;IAChE,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAqB,EAAE,QAAgB;IAC9E,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAEvF,MAAM,OAAO,GAAG,KAAK,EAAE,GAAW,EAAqB,EAAE;QACrD,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;QAC3E,OAAO,GAAG,CAAC;IACf,CAAC,CAAC;IAEF,IAAI,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QACpD,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,IAAI,UAAU,GAAG,CAAC,MAAM,SAAS,OAAO,EAAE,CAAC,CAAC;IAEpG,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAwC,EAAE,MAAM,CAAC,CAAC;AACzE,CAAC"}

package/dist/modrinth.d.ts

@@ -0,0 +1,67 @@
+import type { PlatformAdapter } from "./platform-adapter.js";
+export interface ModrinthVersion {
+    id: string;
+    project_id: string;
+    name: string;
+    version_number: string;
+    date_published: string;
+    downloads: number;
+    files: Array<{
+        url: string;
+        filename: string;
+        primary: boolean;
+        hashes: {
+            sha512: string;
+        };
+    }>;
+}
+export interface ModrinthProject {
+    id: string;
+    slug: string;
+    title: string;
+    description: string;
+    source_url: string | null;
+    issues_url: string | null;
+}
+export declare function lookupBySha512(sha512: string): Promise<ModrinthVersion | null>;
+export declare function getProject(projectId: string): Promise<ModrinthProject | null>;
+export declare function getLatestVersion(projectId: string, mcVersion?: string): Promise<ModrinthVersion | null>;
+export interface ModrinthSearchHit {
+    project_id: string;
+    slug: string;
+    title: string;
+    description: string;
+    categories: string[];
+    downloads: number;
+    follows: number;
+    latest_version: string;
+    versions: string[];
+    loaders: string[];
+    date_modified: string;
+    license: string;
+    project_type: string;
+}
+export interface ModrinthSearchResult {
+    hits: ModrinthSearchHit[];
+    offset: number;
+    limit: number;
+    total_hits: number;
+}
+/**
+ * Search Modrinth by name/keyword, optionally filtered by loader and/or MC version.
+ */
+export declare function searchProjects(query: string, opts?: {
+    loader?: string;
+    mcVersion?: string;
+    limit?: number;
+    projectType?: string;
+}): Promise<ModrinthSearchResult | null>;
+/**
+ * Get all versions for a project, optionally filtered by loader and/or MC version.
+ */
+export declare function getProjectVersions(projectId: string, opts?: {
+    loader?: string;
+    mcVersion?: string;
+}): Promise<ModrinthVersion[]>;
+export declare const modrinthPlatformAdapter: PlatformAdapter;
+//# sourceMappingURL=modrinth.d.ts.map

package/dist/modrinth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modrinth.d.ts","sourceRoot":"","sources":["../src/modrinth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAU7D,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;SAAE,CAAC;KAAE,CAAC,CAAC;CACnG;AAED,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAOpF;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAKnF;AAED,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAO7G;AAED,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACzF,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CActC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACpC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,eAAe,EAAE,CAAC,CAO5B;AAED,eAAO,MAAM,uBAAuB,EAAE,eAcrC,CAAC"}

package/dist/modrinth.js

@@ -0,0 +1,88 @@
+import { fetchWithRetry, safeJson } from "./fetch-utils.js";
+const MODRINTH_BASE = "https://api.modrinth.com/v2";
+const token = process.env.MODRINTH_TOKEN ?? "";
+const headers = {
+    "User-Agent": "modlens-mcp/1.0 (github.com/CreeperHost/modlens-mcp)",
+    ...(token ? { Authorization: token } : {}),
+};
+export async function lookupBySha512(sha512) {
+    if (!/^[a-f0-9]{128}$/i.test(sha512))
+        throw new Error(`Invalid SHA-512 hash: expected 128 hex chars, got ${sha512.length} chars`);
+    const res = await fetchWithRetry(`${MODRINTH_BASE}/version_file/${sha512}?algorithm=sha512`, { headers });
+    if (res.status === 404)
+        return null;
+    if (!res.ok)
+        throw new Error(`Modrinth lookup failed: ${res.status}`);
+    return safeJson(res, "Modrinth version lookup");
+}
+export async function getProject(projectId) {
+    const res = await fetchWithRetry(`${MODRINTH_BASE}/project/${projectId}`, { headers });
+    if (res.status === 404)
+        return null;
+    if (!res.ok)
+        throw new Error(`Modrinth project fetch failed: ${res.status}`);
+    return safeJson(res, "Modrinth project");
+}
+export async function getLatestVersion(projectId, mcVersion) {
+    const params = new URLSearchParams({ loaders: '["fabric","neoforge","forge","quilt"]' });
+    if (mcVersion)
+        params.set("game_versions", JSON.stringify([mcVersion]));
+    const res = await fetchWithRetry(`${MODRINTH_BASE}/project/${projectId}/version?${params}`, { headers });
+    if (!res.ok)
+        return null;
+    const versions = await safeJson(res, "Modrinth versions");
+    return versions[0] ?? null;
+}
+/**
+ * Search Modrinth by name/keyword, optionally filtered by loader and/or MC version.
+ */
+export async function searchProjects(query, opts = {}) {
+    const facets = [["project_type:mod"]];
+    if (opts.loader)
+        facets.push([`categories:${opts.loader}`]);
+    if (opts.mcVersion)
+        facets.push([`versions:${opts.mcVersion}`]);
+    if (opts.projectType)
+        facets[0] = [`project_type:${opts.projectType}`];
+    const params = new URLSearchParams({
+        query,
+        limit: String(opts.limit ?? 20),
+        facets: JSON.stringify(facets),
+    });
+    const res = await fetchWithRetry(`${MODRINTH_BASE}/search?${params}`, { headers });
+    if (!res.ok)
+        return null;
+    return safeJson(res, "Modrinth search");
+}
+/**
+ * Get all versions for a project, optionally filtered by loader and/or MC version.
+ */
+export async function getProjectVersions(projectId, opts = {}) {
+    const params = new URLSearchParams();
+    if (opts.loader)
+        params.set("loaders", JSON.stringify([opts.loader]));
+    if (opts.mcVersion)
+        params.set("game_versions", JSON.stringify([opts.mcVersion]));
+    const res = await fetchWithRetry(`${MODRINTH_BASE}/project/${projectId}/version?${params}`, { headers });
+    if (!res.ok)
+        return [];
+    return safeJson(res, "Modrinth project versions");
+}
+export const modrinthPlatformAdapter = {
+    name: "modrinth",
+    async lookup({ sha512 }) {
+        if (!sha512)
+            return null;
+        const ver = await lookupBySha512(sha512).catch(() => null);
+        if (!ver)
+            return null;
+        const proj = await getProject(ver.project_id).catch(() => null);
+        return {
+            platform: "modrinth",
+            projectId: ver.project_id,
+            slug: proj?.slug,
+            sourceUrl: proj?.source_url,
+        };
+    },
+};
+//# sourceMappingURL=modrinth.js.map

package/dist/modrinth.js.map

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

package/dist/platform-adapter.d.ts

@@ -0,0 +1,23 @@
+/** Hashes available for a mod JAR at ingest time. */
+export type JarHashes = {
+    sha512: string | null;
+    murmur2: string | null;
+};
+/** Result from a successful platform lookup. */
+export type PlatformHit = {
+    platform: "modrinth";
+    projectId: string;
+    slug?: string;
+    sourceUrl?: string | null;
+} | {
+    platform: "curseforge";
+    projectId: number;
+    slug?: string;
+    sourceUrl?: string;
+};
+/** An adapter that can identify a mod JAR on one platform. */
+export type PlatformAdapter = {
+    name: string;
+    lookup: (hashes: JarHashes) => Promise<PlatformHit | null>;
+};
+//# sourceMappingURL=platform-adapter.d.ts.map

package/dist/platform-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-adapter.d.ts","sourceRoot":"","sources":["../src/platform-adapter.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,MAAM,SAAS,GAAG;IACpB,MAAM,EAAG,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,WAAW,GACjB;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACvF;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF,8DAA8D;AAC9D,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC9D,CAAC"}

package/dist/platform-adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform-adapter.js.map

package/dist/platform-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-adapter.js","sourceRoot":"","sources":["../src/platform-adapter.ts"],"names":[],"mappings":""}

package/dist/platform.d.ts

@@ -0,0 +1,47 @@
+export interface MCVersion {
+    id: string;
+    type: "release" | "snapshot" | "old_beta" | "old_alpha";
+    releaseTime: string;
+}
+export interface NeoForgeVersion {
+    version: string;
+    mcVersion: string;
+}
+export interface FabricApiVersion {
+    version: string;
+    mcVersion: string;
+    datePublished: string;
+}
+export interface ForgeVersion {
+    /** Full artifact version, e.g. "1.20.1-47.3.22" */
+    fullVersion: string;
+    /** Forge build version, e.g. "47.3.22" */
+    version: string;
+    /** Minecraft version, e.g. "1.20.1" */
+    mcVersion: string;
+    /** Whether this is the recommended build */
+    recommended?: boolean;
+}
+export declare function listMcVersions(type?: "release" | "snapshot" | "all"): Promise<MCVersion[]>;
+export declare function listNeoForgeVersions(mcVersion?: string, limit?: number): Promise<NeoForgeVersion[]>;
+export declare function listFabricApiVersions(mcVersion?: string, limit?: number): Promise<FabricApiVersion[]>;
+export declare function listForgeVersions(mcVersion?: string, limit?: number): Promise<ForgeVersion[]>;
+/**
+ * Download the NeoForge universal JAR for a given version.
+ * Version format: "21.1.228" (maps to MC 1.21.1).
+ * Returns the local JAR path.
+ */
+export declare function downloadNeoForge(version: string): Promise<string>;
+/**
+ * Download the Forge universal JAR for a given version.
+ * Version format: "1.20.1-47.3.22" (full artifact version) or just "47.3.22" with mcVersion.
+ * Returns the local JAR path.
+ */
+export declare function downloadForge(version: string, mcVersion?: string): Promise<string>;
+/**
+ * Download the Fabric API JAR for a given version from Modrinth.
+ * Version format: "0.116.11+1.21.1".
+ * Returns the local JAR path.
+ */
+export declare function downloadFabricApi(version: string): Promise<string>;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IACxD,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IACzB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAMD,wBAAsB,cAAc,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAahG;AAED,wBAAsB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAqBrG;AAED,wBAAsB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoBvG;AAED,wBAAsB,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAmD/F;AAYD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIvE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUxF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBxE"}

package/dist/platform.js

@@ -0,0 +1,175 @@
+import { createWriteStream } from "fs";
+import { pipeline } from "stream/promises";
+import { join } from "path";
+import { CACHE_ROOT, ensureDir, exists } from "./cache.js";
+import { LEGACY_SRG_VERSIONS, LEGACY_RETROMCP_VERSIONS } from "./minecraft.js";
+const PISTON_META = "https://piston-meta.mojang.com/mc/game/version_manifest_v2.json";
+const NEOFORGE_MAVEN = "https://maven.neoforged.net/releases/net/neoforged/neoforge";
+const NEOFORGE_META = "https://maven.neoforged.net/api/maven/versions/releases/net/neoforged/neoforge";
+const FORGE_MAVEN = "https://maven.minecraftforge.net/net/minecraftforge/forge";
+const FORGE_PROMOS = "https://files.minecraftforge.net/net/minecraftforge/forge/promotions_slim.json";
+let mcCache = null;
+let neoforgeCache = null;
+let forgeCache = null;
+export async function listMcVersions(type) {
+    if (!mcCache) {
+        const res = await fetch(PISTON_META);
+        if (!res.ok)
+            throw new Error(`Failed to fetch MC versions: ${res.status}`);
+        const data = await res.json();
+        mcCache = data.versions.filter((v) => v.type !== "old_beta" && v.type !== "old_alpha" &&
+            (new Date(v.releaseTime) >= new Date("2019-04-23") || LEGACY_SRG_VERSIONS.has(v.id) || LEGACY_RETROMCP_VERSIONS.has(v.id)));
+    }
+    if (!type || type === "all")
+        return mcCache;
+    if (type === "release")
+        return mcCache.filter((v) => v.type === "release");
+    return mcCache.filter((v) => v.type === "snapshot");
+}
+export async function listNeoForgeVersions(mcVersion, limit = 20) {
+    if (!neoforgeCache) {
+        const res = await fetch(NEOFORGE_META);
+        if (!res.ok)
+            throw new Error(`Failed to fetch NeoForge versions: ${res.status}`);
+        const data = await res.json();
+        // NeoForge versions look like "21.1.0", "21.1.1", etc. — leading number = MC major
+        neoforgeCache = data.versions
+            .filter((v) => /^\d+\.\d+\.\d+/.test(v))
+            .map((v) => {
+            const parts = v.split(".");
+            const mcVersion = `1.${parts[0]}.${parts[1]}`;
+            return { version: v, mcVersion };
+        })
+            .reverse(); // newest first
+    }
+    const filtered = mcVersion
+        ? neoforgeCache.filter((v) => v.mcVersion === mcVersion || v.mcVersion.startsWith(mcVersion))
+        : neoforgeCache;
+    return filtered.slice(0, limit);
+}
+export async function listFabricApiVersions(mcVersion, limit = 20) {
+    // Fabric API project on Modrinth: P7dR8mSH
+    const url = mcVersion
+        ? `https://api.modrinth.com/v2/project/P7dR8mSH/version?game_versions=%5B%22${encodeURIComponent(mcVersion)}%22%5D&loaders=%5B%22fabric%22%5D`
+        : `https://api.modrinth.com/v2/project/P7dR8mSH/version?loaders=%5B%22fabric%22%5D`;
+    const res = await fetch(url, { headers: { "User-Agent": "modlens-mcp/1.0" } });
+    if (!res.ok)
+        throw new Error(`Failed to fetch Fabric API versions: ${res.status}`);
+    const versions = await res.json();
+    return versions.slice(0, limit).map((v) => ({
+        version: v.version_number,
+        mcVersion: v.game_versions[0] ?? "unknown",
+        datePublished: v.date_published,
+    }));
+}
+export async function listForgeVersions(mcVersion, limit = 20) {
+    if (!forgeCache) {
+        // Fetch promotions to know which versions are recommended
+        const promoRes = await fetch(FORGE_PROMOS, { headers: { "User-Agent": "modlens-mcp/1.0" } });
+        const recommendedSet = new Set();
+        if (promoRes.ok) {
+            const promoData = await promoRes.json();
+            for (const [key, ver] of Object.entries(promoData.promos)) {
+                if (key.endsWith("-recommended")) {
+                    const mc = key.replace("-recommended", "");
+                    recommendedSet.add(`${mc}-${ver}`);
+                }
+            }
+        }
+        // Fetch Maven metadata for full version list
+        const metaRes = await fetch(`${FORGE_MAVEN}/maven-metadata.xml`, { headers: { "User-Agent": "modlens-mcp/1.0" } });
+        if (!metaRes.ok)
+            throw new Error(`Failed to fetch Forge versions: ${metaRes.status}`);
+        const xml = await metaRes.text();
+        // Parse <version> tags from XML
+        const versionRegex = /<version>([^<]+)<\/version>/g;
+        const allVersions = [];
+        let match;
+        while ((match = versionRegex.exec(xml)) !== null) {
+            const fullVersion = match[1];
+            // Format: "mcVersion-forgeVersion" (e.g. "1.20.1-47.3.22")
+            // Some old ones: "1.7.10-10.13.4.1614-1.7.10" (MC version appended twice)
+            const dashIdx = fullVersion.indexOf("-");
+            if (dashIdx === -1)
+                continue;
+            const mc = fullVersion.substring(0, dashIdx);
+            // Strip trailing "-mcVersion" suffix from old Forge versions
+            let forgeVer = fullVersion.substring(dashIdx + 1);
+            if (forgeVer.endsWith(`-${mc}`)) {
+                forgeVer = forgeVer.substring(0, forgeVer.length - mc.length - 1);
+            }
+            allVersions.push({
+                fullVersion,
+                version: forgeVer,
+                mcVersion: mc,
+                recommended: recommendedSet.has(fullVersion),
+            });
+        }
+        forgeCache = allVersions.reverse(); // newest first
+    }
+    const filtered = mcVersion
+        ? forgeCache.filter((v) => v.mcVersion === mcVersion || v.mcVersion.startsWith(mcVersion))
+        : forgeCache;
+    return filtered.slice(0, limit);
+}
+async function downloadJar(url, destPath) {
+    await ensureDir(destPath);
+    if (await exists(destPath))
+        return destPath;
+    const res = await fetch(url, { headers: { "User-Agent": "modlens-mcp/1.0" } });
+    if (!res.ok)
+        throw new Error(`Download failed (${res.status}): ${url}`);
+    const writer = createWriteStream(destPath);
+    await pipeline(res.body, writer);
+    return destPath;
+}
+/**
+ * Download the NeoForge universal JAR for a given version.
+ * Version format: "21.1.228" (maps to MC 1.21.1).
+ * Returns the local JAR path.
+ */
+export async function downloadNeoForge(version) {
+    const destPath = join(CACHE_ROOT, "loaders", "neoforge", `neoforge-${version}-universal.jar`);
+    const url = `${NEOFORGE_MAVEN}/${version}/neoforge-${version}-universal.jar`;
+    return downloadJar(url, destPath);
+}
+/**
+ * Download the Forge universal JAR for a given version.
+ * Version format: "1.20.1-47.3.22" (full artifact version) or just "47.3.22" with mcVersion.
+ * Returns the local JAR path.
+ */
+export async function downloadForge(version, mcVersion) {
+    let fullVersion = version;
+    // If user only provided the Forge build number (no dash), we need mcVersion to construct the full version
+    if (!version.includes("-")) {
+        if (!mcVersion)
+            throw new Error("Forge download requires either full version (e.g. 1.20.1-47.3.22) or version + mcVersion");
+        fullVersion = `${mcVersion}-${version}`;
+    }
+    const destPath = join(CACHE_ROOT, "loaders", "forge", `forge-${fullVersion}-universal.jar`);
+    const url = `${FORGE_MAVEN}/${fullVersion}/forge-${fullVersion}-universal.jar`;
+    return downloadJar(url, destPath);
+}
+/**
+ * Download the Fabric API JAR for a given version from Modrinth.
+ * Version format: "0.116.11+1.21.1".
+ * Returns the local JAR path.
+ */
+export async function downloadFabricApi(version) {
+    const destPath = join(CACHE_ROOT, "loaders", "fabric-api", `fabric-api-${version}.jar`);
+    if (await exists(destPath))
+        return destPath;
+    // Fetch the version file list from Modrinth
+    const res = await fetch(`https://api.modrinth.com/v2/project/P7dR8mSH/version?loaders=%5B%22fabric%22%5D`, { headers: { "User-Agent": "modlens-mcp/1.0" } });
+    if (!res.ok)
+        throw new Error(`Modrinth lookup failed: ${res.status}`);
+    const versions = await res.json();
+    const match = versions.find((v) => v.version_number === version);
+    if (!match)
+        throw new Error(`Fabric API version "${version}" not found on Modrinth`);
+    const file = match.files.find((f) => f.primary) ?? match.files[0];
+    if (!file)
+        throw new Error(`No download file found for Fabric API ${version}`);
+    return downloadJar(file.url, destPath);
+}
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

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

package/dist/processor.d.ts

@@ -0,0 +1,51 @@
+import AdmZip from "adm-zip";
+export type MetadataSource = "fabric.mod.json" | "quilt.mod.json" | "mods.toml" | "mcmod.info" | "@Mod annotation" | "filename";
+/** Higher = better quality metadata. Used to decide whether re-parse upgrades an existing record. */
+export declare const METADATA_QUALITY: Record<MetadataSource, number>;
+export interface ParsedManifest {
+    modId: string;
+    displayName: string;
+    version: string;
+    mcVersion: string;
+    loader: "fabric" | "neoforge" | "forge" | "quilt" | "unknown";
+    description: string;
+    sourceUrl: string | null;
+    dependencies: Array<{
+        id: string;
+        version: string;
+        required: boolean;
+    }>;
+    mixinConfigs: string[];
+    hasMixins: boolean;
+    hasAt: boolean;
+    hasAw: boolean;
+    atEntries: string[];
+    awEntries: string[];
+    mixinTargets: string[];
+    metadataSource: MetadataSource;
+}
+export declare function parseJar(jarPath: string): Promise<ParsedManifest>;
+interface ForgeModAnnotationResult {
+    modId: string;
+    name: string;
+    version: string;
+}
+/**
+ * Scan class entries in a JAR for the Forge @Mod annotation.
+ * Parses the constant pool and RuntimeVisibleAnnotations attribute
+ * to extract modid/name/version without requiring javap.
+ */
+export declare function extractForgeModAnnotation(zip: AdmZip): ForgeModAnnotationResult | null;
+/** Parse a single .class file's bytes for a Forge @Mod annotation. */
+export declare function parseClassForModAnnotation(buf: Buffer): ForgeModAnnotationResult | null;
+export declare function parseAtEntries(content: string): string[];
+export declare function parseAwEntries(content: string): string[];
+export declare function computeHashes(jarPath: string): Promise<{
+    sha256: string;
+    sha512: string;
+    murmur2: string;
+}>;
+/** CurseForge Murmur2 hash — matches CF API fingerprint (whitespace-normalized). */
+export declare function computeMurmur2(data: Buffer): number;
+export {};
+//# sourceMappingURL=processor.d.ts.map