codex-skills-mcp 1.0.0

package/dist/tools/list-skill-files.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+export function registerListSkillFiles(server, searchEngine, loader) {
+    server.tool("list_skill_files", "List the file tree of a skill or a subdirectory within it. Use this to understand a large skill's structure before deciding which files to load.", {
+        skill_name: z.string().describe("Skill name, e.g. 'KrillinAI'"),
+        path: z.string().optional().default("").describe("Subdirectory path within the skill (default: root)"),
+        max_depth: z.number().optional().default(2).describe("Directory scan depth (default: 2)"),
+    }, async ({ skill_name, path, max_depth }) => {
+        const entry = searchEngine.findByName(skill_name);
+        if (!entry) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Skill "${skill_name}" not found.`,
+                    },
+                ],
+            };
+        }
+        try {
+            const files = await loader.listSkillFiles(entry, path, max_depth);
+            const treeStr = formatFileTree(files, "");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## ${skill_name}${path ? "/" + path : ""} file tree\n\n\`\`\`\n${treeStr}\n\`\`\`\n\nUse load_skill_file(skill_name, file_path) to read any file.`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+function formatFileTree(nodes, indent) {
+    const lines = [];
+    for (const node of nodes) {
+        if (node.type === "directory") {
+            lines.push(`${indent}📁 ${node.name}/`);
+            if (node.children) {
+                lines.push(formatFileTree(node.children, indent + "  "));
+            }
+        }
+        else {
+            const size = node.size_bytes
+                ? ` (${node.size_bytes > 1024 ? Math.round(node.size_bytes / 1024) + "KB" : node.size_bytes + "B"})`
+                : "";
+            lines.push(`${indent}📄 ${node.name}${size}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=list-skill-files.js.map

package/dist/tools/list-skill-files.js.map

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

package/dist/tools/load-skill-file.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SkillSearchEngine } from "../search/index.js";
+import type { SkillLoader } from "../loader/index.js";
+export declare function registerLoadSkillFile(server: McpServer, searchEngine: SkillSearchEngine, loader: SkillLoader): void;
+//# sourceMappingURL=load-skill-file.d.ts.map

package/dist/tools/load-skill-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-skill-file.d.ts","sourceRoot":"","sources":["../../src/tools/load-skill-file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,iBAAiB,EAC/B,MAAM,EAAE,WAAW,GAClB,IAAI,CA4CN"}

package/dist/tools/load-skill-file.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export function registerLoadSkillFile(server, searchEngine, loader) {
+    server.tool("load_skill_file", "Read a specific file from within a skill's directory. Use this after read_skill when you need to access scripts, configs, README, or other resources referenced in the skill instructions.", {
+        skill_name: z.string().describe("Skill name, e.g. 'MediaCrawler'"),
+        file_path: z.string().describe("Relative path within the skill directory, e.g. 'README.md' or 'scripts/run.py'"),
+    }, async ({ skill_name, file_path }) => {
+        const entry = searchEngine.findByName(skill_name);
+        if (!entry) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Skill "${skill_name}" not found.`,
+                    },
+                ],
+            };
+        }
+        try {
+            const { content, size_bytes } = await loader.loadSkillFile(entry, file_path);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## ${skill_name} / ${file_path} (${size_bytes} bytes)\n\n${content}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error loading file: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=load-skill-file.js.map

package/dist/tools/load-skill-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-skill-file.js","sourceRoot":"","sources":["../../src/tools/load-skill-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,YAA+B,EAC/B,MAAmB;IAEnB,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,4LAA4L,EAC5L;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;KACjH,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAU,UAAU,cAAc;qBACzC;iBACF;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YAE7E,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM,UAAU,MAAM,SAAS,KAAK,UAAU,cAAc,OAAO,EAAE;qBAC5E;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;qBAChF;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/plan-workflow.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SkillSearchEngine } from "../search/index.js";
+export declare function registerPlanWorkflow(server: McpServer, searchEngine: SkillSearchEngine): void;
+//# sourceMappingURL=plan-workflow.d.ts.map

package/dist/tools/plan-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-workflow.d.ts","sourceRoot":"","sources":["../../src/tools/plan-workflow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,iBAAiB,GAC9B,IAAI,CA8DN"}

package/dist/tools/plan-workflow.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+export function registerPlanWorkflow(server, searchEngine) {
+    server.tool("plan_workflow", "Given a task description, suggest relevant skills that could be combined to accomplish it. Returns a list of recommended skills — the actual orchestration and execution order should be decided by you (the Agent).", {
+        task_description: z.string().describe("Full description of the task to accomplish, e.g. '把技术博客文章转换成小红书图文并发布'"),
+    }, async ({ task_description }) => {
+        // Use a broader search to find related skills
+        const results = searchEngine.search(task_description, { limit: 15 });
+        if (results.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No skills found for this task. Consider breaking it down into smaller sub-tasks and searching individually.`,
+                    },
+                ],
+            };
+        }
+        // Group by category for better overview
+        const byCategory = new Map();
+        for (const r of results) {
+            const list = byCategory.get(r.category) || [];
+            list.push(r);
+            byCategory.set(r.category, list);
+        }
+        let output = `## Workflow Suggestions for:\n> ${task_description}\n\n`;
+        output += `Found ${results.length} potentially relevant skills:\n\n`;
+        // Top recommendations (score > 3)
+        const topSkills = results.filter((r) => r.score > 3);
+        if (topSkills.length > 0) {
+            output += "### 🎯 Top Recommendations\n";
+            for (const s of topSkills) {
+                output += `- **${s.name}** (score: ${s.score}) — ${s.description.substring(0, 150)}...\n`;
+            }
+            output += "\n";
+        }
+        // All by category
+        output += "### 📂 By Category\n";
+        for (const [category, skills] of byCategory) {
+            output += `\n**${category}**:\n`;
+            for (const s of skills) {
+                output += `  - ${s.name} (score: ${s.score})\n`;
+            }
+        }
+        output += "\n---\n";
+        output +=
+            "Use read_skill(name) to load each skill's instructions. " +
+                "You should determine the execution order and how to chain the skills based on your task analysis.";
+        return {
+            content: [{ type: "text", text: output }],
+        };
+    });
+}
+//# sourceMappingURL=plan-workflow.js.map

package/dist/tools/plan-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-workflow.js","sourceRoot":"","sources":["../../src/tools/plan-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,YAA+B;IAE/B,MAAM,CAAC,IAAI,CACT,eAAe,EACf,sNAAsN,EACtN;QACE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;KAC/G,EACD,KAAK,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;QAC7B,8CAA8C;QAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAErE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,6GAA6G;qBACpH;iBACF;aACF,CAAC;QACJ,CAAC;QAED,wCAAwC;QACxC,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACb,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,MAAM,GAAG,mCAAmC,gBAAgB,MAAM,CAAC;QACvE,MAAM,IAAI,SAAS,OAAO,CAAC,MAAM,mCAAmC,CAAC;QAErE,kCAAkC;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,8BAA8B,CAAC;YACzC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;YAC5F,CAAC;YACD,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC;QAED,kBAAkB;QAClB,MAAM,IAAI,sBAAsB,CAAC;QACjC,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC5C,MAAM,IAAI,OAAO,QAAQ,OAAO,CAAC;YACjC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,KAAK,KAAK,CAAC;YAClD,CAAC;QACH,CAAC;QAED,MAAM,IAAI,SAAS,CAAC;QACpB,MAAM;YACJ,0DAA0D;gBAC1D,mGAAmG,CAAC;QAEtG,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACnD,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/read-skill.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SkillSearchEngine } from "../search/index.js";
+import type { SkillLoader } from "../loader/index.js";
+export declare function registerReadSkill(server: McpServer, searchEngine: SkillSearchEngine, loader: SkillLoader): void;
+//# sourceMappingURL=read-skill.d.ts.map

package/dist/tools/read-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-skill.d.ts","sourceRoot":"","sources":["../../src/tools/read-skill.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,iBAAiB,EAC/B,MAAM,EAAE,WAAW,GAClB,IAAI,CAwFN"}

package/dist/tools/read-skill.js

@@ -0,0 +1,100 @@
+import { z } from "zod";
+export function registerReadSkill(server, searchEngine, loader) {
+    server.tool("read_skill", "Read a skill's full instructions (SKILL.md), file structure, and dependency info. Call this after search_skills to load a skill you want to use. The instructions contain the role and execution rules you should follow.", {
+        name: z.string().describe("Exact skill name from search results, e.g. 'MediaCrawler'"),
+    }, async ({ name }) => {
+        const entry = searchEngine.findByName(name);
+        if (!entry) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Skill "${name}" not found. Use search_skills to find available skills.`,
+                    },
+                ],
+            };
+        }
+        try {
+            const result = await loader.readSkill(entry);
+            // Format structure as a compact tree
+            const structureStr = formatTree(result.structure.files, "");
+            // Format sub-skills if any
+            let subSkillsStr = "";
+            if (result.structure.sub_skills.length > 0) {
+                subSkillsStr =
+                    "\n\n## Sub-Skills\n" +
+                        result.structure.sub_skills
+                            .map((s) => `- **${s.name}** (${s.path}): ${s.description}`)
+                            .join("\n");
+                subSkillsStr +=
+                    "\n\nUse read_skill or load_skill_file to access sub-skill instructions.";
+            }
+            // Format dependencies
+            const depsStr = [
+                `Language: ${result.dependencies.language}`,
+                result.dependencies.package_manager
+                    ? `Package Manager: ${result.dependencies.package_manager}`
+                    : null,
+                result.dependencies.setup_command
+                    ? `Setup: \`${result.dependencies.setup_command}\``
+                    : null,
+            ]
+                .filter(Boolean)
+                .join(" | ");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            `# Skill: ${entry.name}`,
+                            `**Category**: ${entry.category}`,
+                            `**Dependencies**: ${depsStr}`,
+                            "",
+                            "## Instructions",
+                            "",
+                            result.instructions,
+                            "",
+                            "## File Structure",
+                            "```",
+                            structureStr,
+                            "```",
+                            subSkillsStr,
+                            "",
+                            "---",
+                            "Use load_skill_file(skill_name, file_path) to read any file shown above.",
+                        ].join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error reading skill "${name}": ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+function formatTree(nodes, indent) {
+    const lines = [];
+    for (const node of nodes) {
+        if (node.type === "directory") {
+            lines.push(`${indent}📁 ${node.name}/`);
+            if (node.children) {
+                lines.push(formatTree(node.children, indent + "  "));
+            }
+        }
+        else {
+            const size = node.size_bytes
+                ? ` (${node.size_bytes > 1024 ? Math.round(node.size_bytes / 1024) + "KB" : node.size_bytes + "B"})`
+                : "";
+            lines.push(`${indent}📄 ${node.name}${size}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=read-skill.js.map

package/dist/tools/read-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-skill.js","sourceRoot":"","sources":["../../src/tools/read-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,YAA+B,EAC/B,MAAmB;IAEnB,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,2NAA2N,EAC3N;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;KACvF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAU,IAAI,0DAA0D;qBAC/E;iBACF;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAE7C,qCAAqC;YACrC,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAE5D,2BAA2B;YAC3B,IAAI,YAAY,GAAG,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,YAAY;oBACV,qBAAqB;wBACrB,MAAM,CAAC,SAAS,CAAC,UAAU;6BACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;6BAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChB,YAAY;oBACV,yEAAyE,CAAC;YAC9E,CAAC;YAED,sBAAsB;YACtB,MAAM,OAAO,GAAG;gBACd,aAAa,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE;gBAC3C,MAAM,CAAC,YAAY,CAAC,eAAe;oBACjC,CAAC,CAAC,oBAAoB,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE;oBAC3D,CAAC,CAAC,IAAI;gBACR,MAAM,CAAC,YAAY,CAAC,aAAa;oBAC/B,CAAC,CAAC,YAAY,MAAM,CAAC,YAAY,CAAC,aAAa,IAAI;oBACnD,CAAC,CAAC,IAAI;aACT;iBACE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,KAAK,CAAC,CAAC;YAEf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;4BACJ,YAAY,KAAK,CAAC,IAAI,EAAE;4BACxB,iBAAiB,KAAK,CAAC,QAAQ,EAAE;4BACjC,qBAAqB,OAAO,EAAE;4BAC9B,EAAE;4BACF,iBAAiB;4BACjB,EAAE;4BACF,MAAM,CAAC,YAAY;4BACnB,EAAE;4BACF,mBAAmB;4BACnB,KAAK;4BACL,YAAY;4BACZ,KAAK;4BACL,YAAY;4BACZ,EAAE;4BACF,KAAK;4BACL,0EAA0E;yBAC3E,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,wBAAwB,IAAI,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;qBAC3F;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAA8E,EAAE,MAAc;IAChH,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU;gBAC1B,CAAC,CAAC,KAAK,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,GAAG,GAAG;gBACpG,CAAC,CAAC,EAAE,CAAC;YACP,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/search-skills.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SkillSearchEngine } from "../search/index.js";
+export declare function registerSearchSkills(server: McpServer, searchEngine: SkillSearchEngine): void;
+//# sourceMappingURL=search-skills.d.ts.map

package/dist/tools/search-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-skills.d.ts","sourceRoot":"","sources":["../../src/tools/search-skills.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,iBAAiB,GAC9B,IAAI,CAwCN"}

package/dist/tools/search-skills.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export function registerSearchSkills(server, searchEngine) {
+    server.tool("search_skills", "Search the codex-skills library by natural language query. Returns matching skills ranked by relevance. Use this as the primary entry point to discover skills for a task.", {
+        query: z.string().describe("Natural language description of what you need, e.g. '前端性能优化' or 'video subtitle translation'"),
+        category: z.string().optional().describe("Optional category filter, e.g. '05_多媒体与设计资产'"),
+        limit: z.number().optional().default(8).describe("Max number of results to return (default: 8)"),
+    }, async ({ query, category, limit }) => {
+        const results = searchEngine.search(query, { category, limit });
+        if (results.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No skills found matching "${query}". Try broader keywords or use list_categories to browse available skills.`,
+                    },
+                ],
+            };
+        }
+        const formatted = results
+            .map((r, i) => `${i + 1}. **${r.name}** [${r.category}] (score: ${r.score})\n   ${r.description.substring(0, 200)}${r.description.length > 200 ? "..." : ""}`)
+            .join("\n\n");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Found ${results.length} matching skills:\n\n${formatted}\n\nUse read_skill(name) to load a skill's full instructions.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=search-skills.js.map

package/dist/tools/search-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-skills.js","sourceRoot":"","sources":["../../src/tools/search-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,YAA+B;IAE/B,MAAM,CAAC,IAAI,CACT,eAAe,EACf,4KAA4K,EAC5K;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8FAA8F,CAAC;QAC1H,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QACxF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KACjG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QACnC,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAEhE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,6BAA6B,KAAK,4EAA4E;qBACrH;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,OAAO;aACtB,GAAG,CACF,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,aAAa,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACjJ;aACA,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,SAAS,OAAO,CAAC,MAAM,wBAAwB,SAAS,+DAA+D;iBAC9H;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "codex-skills-mcp",
+  "version": "1.0.0",
+  "description": "MCP Server for Codex-Skills - Intelligent skill library search, read and orchestration",
+  "type": "module",
+  "bin": {
+    "codex-skills-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "codex-skills",
+    "ai-skills",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "express": "^5.2.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}