@webiny/mcp 0.0.0-unstable.6844005670

package/cli/ConfigureMcp.js

@@ -0,0 +1,57 @@
+import { CliCommandFactory } from "@webiny/cli-core/exports/cli/command.js";
+import { Ui } from "@webiny/cli-core/exports/cli/index.js";
+const SUPPORTED = ["claude", "cursor", "windsurf", "copilot", "cline"];
+class ConfigureMcp {
+  constructor(ui) {
+    this.ui = ui;
+  }
+  execute() {
+    return {
+      name: "configure-mcp",
+      description: "Configure MCP server for a specific agent.",
+      examples: ["$0 configure-mcp claude", "$0 configure-mcp cursor", "$0 configure-mcp --instructions"],
+      params: [{
+        name: "agent",
+        description: "Agent name (claude, cursor, windsurf, copilot, cline)",
+        type: "string",
+        default: "claude"
+      }],
+      options: [{
+        name: "instructions",
+        description: "Print MCP setup instructions",
+        type: "boolean",
+        default: false
+      }],
+      handler: async params => {
+        if (params.instructions) {
+          const {
+            printInstructions
+          } = await import("../agents/instructions.js");
+          printInstructions();
+          return;
+        }
+        const target = params.agent || "claude";
+        if (!SUPPORTED.includes(target)) {
+          this.ui.error(`Unknown agent "${target}".`);
+          this.ui.text(`Supported: ${SUPPORTED.join(", ")}`);
+          this.ui.text("For other agents run: npx webiny configure-mcp --instructions");
+          process.exit(1);
+        }
+        const cwd = process.cwd();
+        const {
+          init
+        } = await import(`../agents/${target}.js`);
+        await init({
+          ui: this.ui,
+          cwd
+        });
+      }
+    };
+  }
+}
+export default CliCommandFactory.createImplementation({
+  implementation: ConfigureMcp,
+  dependencies: [Ui]
+});
+
+//# sourceMappingURL=ConfigureMcp.js.map

package/cli/ConfigureMcp.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CliCommandFactory","Ui","SUPPORTED","ConfigureMcp","constructor","ui","execute","name","description","examples","params","type","default","options","handler","instructions","printInstructions","target","agent","includes","error","text","join","process","exit","cwd","init","createImplementation","implementation","dependencies"],"sources":["ConfigureMcp.ts"],"sourcesContent":["import { CliCommandFactory } from \"@webiny/cli-core/exports/cli/command.js\";\nimport { Ui } from \"@webiny/cli-core/exports/cli/index.js\";\n\nexport interface IInitAgentParams {\n    agent: string;\n    instructions: boolean;\n}\n\nconst SUPPORTED = [\"claude\", \"cursor\", \"windsurf\", \"copilot\", \"cline\"];\n\nclass ConfigureMcp implements CliCommandFactory.Interface<IInitAgentParams> {\n    constructor(private ui: Ui.Interface) {}\n\n    execute(): CliCommandFactory.CommandDefinition<IInitAgentParams> {\n        return {\n            name: \"configure-mcp\",\n            description: \"Configure MCP server for a specific agent.\",\n            examples: [\n                \"$0 configure-mcp claude\",\n                \"$0 configure-mcp cursor\",\n                \"$0 configure-mcp --instructions\"\n            ],\n            params: [\n                {\n                    name: \"agent\",\n                    description: \"Agent name (claude, cursor, windsurf, copilot, cline)\",\n                    type: \"string\",\n                    default: \"claude\"\n                }\n            ],\n            options: [\n                {\n                    name: \"instructions\",\n                    description: \"Print MCP setup instructions\",\n                    type: \"boolean\",\n                    default: false\n                }\n            ],\n            handler: async params => {\n                if (params.instructions) {\n                    const { printInstructions } = await import(\"../agents/instructions.js\");\n                    printInstructions();\n                    return;\n                }\n\n                const target = params.agent || \"claude\";\n\n                if (!SUPPORTED.includes(target)) {\n                    this.ui.error(`Unknown agent \"${target}\".`);\n                    this.ui.text(`Supported: ${SUPPORTED.join(\", \")}`);\n                    this.ui.text(\"For other agents run: npx webiny configure-mcp --instructions\");\n                    process.exit(1);\n                }\n\n                const cwd = process.cwd();\n                const { init } = await import(`../agents/${target}.js`);\n                await init({ ui: this.ui, cwd });\n            }\n        };\n    }\n}\n\nexport default CliCommandFactory.createImplementation({\n    implementation: ConfigureMcp,\n    dependencies: [Ui]\n});\n"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,yCAAyC;AAC3E,SAASC,EAAE,QAAQ,uCAAuC;AAO1D,MAAMC,SAAS,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC;AAEtE,MAAMC,YAAY,CAA0D;EACxEC,WAAWA,CAASC,EAAgB,EAAE;IAAA,KAAlBA,EAAgB,GAAhBA,EAAgB;EAAG;EAEvCC,OAAOA,CAAA,EAA0D;IAC7D,OAAO;MACHC,IAAI,EAAE,eAAe;MACrBC,WAAW,EAAE,4CAA4C;MACzDC,QAAQ,EAAE,CACN,yBAAyB,EACzB,yBAAyB,EACzB,iCAAiC,CACpC;MACDC,MAAM,EAAE,CACJ;QACIH,IAAI,EAAE,OAAO;QACbC,WAAW,EAAE,uDAAuD;QACpEG,IAAI,EAAE,QAAQ;QACdC,OAAO,EAAE;MACb,CAAC,CACJ;MACDC,OAAO,EAAE,CACL;QACIN,IAAI,EAAE,cAAc;QACpBC,WAAW,EAAE,8BAA8B;QAC3CG,IAAI,EAAE,SAAS;QACfC,OAAO,EAAE;MACb,CAAC,CACJ;MACDE,OAAO,EAAE,MAAMJ,MAAM,IAAI;QACrB,IAAIA,MAAM,CAACK,YAAY,EAAE;UACrB,MAAM;YAAEC;UAAkB,CAAC,GAAG,MAAM,MAAM,4BAA4B,CAAC;UACvEA,iBAAiB,CAAC,CAAC;UACnB;QACJ;QAEA,MAAMC,MAAM,GAAGP,MAAM,CAACQ,KAAK,IAAI,QAAQ;QAEvC,IAAI,CAAChB,SAAS,CAACiB,QAAQ,CAACF,MAAM,CAAC,EAAE;UAC7B,IAAI,CAACZ,EAAE,CAACe,KAAK,CAAC,kBAAkBH,MAAM,IAAI,CAAC;UAC3C,IAAI,CAACZ,EAAE,CAACgB,IAAI,CAAC,cAAcnB,SAAS,CAACoB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;UAClD,IAAI,CAACjB,EAAE,CAACgB,IAAI,CAAC,+DAA+D,CAAC;UAC7EE,OAAO,CAACC,IAAI,CAAC,CAAC,CAAC;QACnB;QAEA,MAAMC,GAAG,GAAGF,OAAO,CAACE,GAAG,CAAC,CAAC;QACzB,MAAM;UAAEC;QAAK,CAAC,GAAG,MAAM,MAAM,CAAC,aAAaT,MAAM,KAAK,CAAC;QACvD,MAAMS,IAAI,CAAC;UAAErB,EAAE,EAAE,IAAI,CAACA,EAAE;UAAEoB;QAAI,CAAC,CAAC;MACpC;IACJ,CAAC;EACL;AACJ;AAEA,eAAezB,iBAAiB,CAAC2B,oBAAoB,CAAC;EAClDC,cAAc,EAAEzB,YAAY;EAC5B0B,YAAY,EAAE,CAAC5B,EAAE;AACrB,CAAC,CAAC","ignoreList":[]}

package/cli/McpServer.d.ts

@@ -0,0 +1,12 @@
+import { CliCommandFactory } from "@webiny/cli-core/exports/cli/command.js";
+export interface IMcpServerParams {
+    skills: string;
+    "additional-skills": string[];
+}
+declare class McpServerCommand implements CliCommandFactory.Interface<IMcpServerParams> {
+    execute(): CliCommandFactory.CommandDefinition<IMcpServerParams>;
+}
+declare const _default: typeof McpServerCommand & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/cli-core/abstractions/features/CliCommand").ICliCommand<any>>;
+};
+export default _default;

package/cli/McpServer.js

@@ -0,0 +1,239 @@
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { join, resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+import { createRequire } from "module";
+import fm from "front-matter";
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CliCommandFactory } from "@webiny/cli-core/exports/cli/command.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// ---------------------------------------------------------------------------
+// Skill discovery
+// ---------------------------------------------------------------------------
+
+/**
+ * Recursively find all SKILL.md files under `dir`.
+ */
+function findSkillFiles(dir) {
+  if (!existsSync(dir)) {
+    return [];
+  }
+  const results = [];
+  for (const entry of readdirSync(dir, {
+    withFileTypes: true
+  })) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...findSkillFiles(fullPath));
+    } else if (entry.isFile() && entry.name === "SKILL.md") {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+/**
+ * Discover skills from multiple directories. First match wins (higher-priority dirs first).
+ */
+function discoverSkills(skillsDirs) {
+  const skills = new Map();
+  for (const dir of skillsDirs) {
+    for (const filePath of findSkillFiles(dir)) {
+      try {
+        const raw = readFileSync(filePath, "utf8");
+        const parsed = fm(raw);
+        const {
+          name,
+          description
+        } = parsed.attributes;
+        if (!name || !description) {
+          console.error(`[webiny-mcp] skipping ${filePath}: missing name or description`);
+          continue;
+        }
+        if (!skills.has(name)) {
+          const context = parsed.attributes.context || "webiny-extensions";
+          skills.set(name, {
+            name,
+            description,
+            context,
+            filePath
+          });
+        }
+      } catch (err) {
+        console.error(`[webiny-mcp] error reading ${filePath}:`, err);
+      }
+    }
+  }
+  return skills;
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function getVersion() {
+  try {
+    return createRequire(import.meta.url)("../../package.json").version;
+  } catch {
+    return "0.0.0";
+  }
+}
+function buildCatalog(skills) {
+  const lines = [`# Webiny Skills  (v${getVersion()})`, ""];
+  if (skills.size === 0) {
+    lines.push("_(No skills found. Add SKILL.md files with front-matter to a skills directory.)_");
+    return lines.join("\n");
+  }
+
+  // Group skills by context.
+  const contextDescriptions = {
+    "webiny-extensions": "Use these skills when writing Webiny extensions (usually in `extensions/`) or making changes to `webiny.config.tsx` (user project development).",
+    "webiny-packages": "Use these skills when writing code in `packages/` (core Webiny framework development)."
+  };
+  const groups = new Map();
+  for (const skill of skills.values()) {
+    const list = groups.get(skill.context) || [];
+    list.push(skill);
+    groups.set(skill.context, list);
+  }
+  for (const [context, contextSkills] of [...groups.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+    lines.push(`## ${context}`, "");
+    const desc = contextDescriptions[context];
+    if (desc) {
+      lines.push(desc, "");
+    }
+    lines.push("| Skill | Description |");
+    lines.push("|---|---|");
+    for (const skill of contextSkills.sort((a, b) => a.name.localeCompare(b.name))) {
+      const skillDesc = skill.description.replace(/\n/g, " ").trim();
+      lines.push(`| \`${skill.name}\` | ${skillDesc} |`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function readSkillContent(skill) {
+  const raw = readFileSync(skill.filePath, "utf8");
+  return fm(raw).body;
+}
+
+// ---------------------------------------------------------------------------
+// CLI Command
+// ---------------------------------------------------------------------------
+
+class McpServerCommand {
+  execute() {
+    return {
+      name: "mcp-server",
+      description: "Start the Webiny MCP server (stdio transport).",
+      examples: ["$0 mcp-server", "$0 mcp-server --skills=./my-skills", "$0 mcp-server --additional-skills=./extra-skills"],
+      options: [{
+        name: "skills",
+        description: "Replace the built-in skills folder entirely. Only skills found in the given path will be served.",
+        type: "string"
+      }, {
+        name: "additional-skills",
+        description: "Add a folder on top of the built-in (or --skills) folder. Can be repeated.",
+        type: "string",
+        array: true
+      }],
+      handler: async params => {
+        const cwd = process.cwd();
+        const builtInSkillsDir = join(__dirname, "..", "skills");
+        const skillsOverride = params.skills;
+        const additionalSkillsDirs = params["additional-skills"] || [];
+        const baseDir = skillsOverride ? resolve(cwd, skillsOverride) : builtInSkillsDir;
+
+        // skillsDirs[0] = highest priority, skillsDirs[last] = lowest priority
+        const skillsDirs = [...[...additionalSkillsDirs].map(p => resolve(cwd, p)).reverse(), baseDir];
+        if (skillsOverride) {
+          console.error(`[webiny-mcp] skills override: ${baseDir}`);
+        }
+        for (const d of additionalSkillsDirs) {
+          console.error(`[webiny-mcp] additional skills: ${resolve(cwd, d)}`);
+        }
+
+        // In-memory cache: populated on first list, reused by get.
+        let skillsCache = null;
+        function getSkills() {
+          if (!skillsCache) {
+            skillsCache = discoverSkills(skillsDirs);
+            console.error(`[webiny-mcp] discovered ${skillsCache.size} skill(s)`);
+          }
+          return skillsCache;
+        }
+
+        // ---------------------------------------------------------------
+        // MCP server
+        // ---------------------------------------------------------------
+
+        const server = new McpServer({
+          name: "webiny",
+          version: getVersion()
+        });
+        server.registerTool("list_webiny_skills", {
+          title: "List Webiny Skills",
+          description: "Returns a catalog of all available Webiny skills with names and descriptions. " + "Always call this first when working on anything Webiny-related, then call " + "get_webiny_skill to load the specific skill you need.",
+          inputSchema: {},
+          annotations: {
+            readOnlyHint: true
+          }
+        }, async () => ({
+          content: [{
+            type: "text",
+            text: buildCatalog(getSkills())
+          }]
+        }));
+
+        // @ts-expect-error Incompatible Zod version
+        server.registerTool("get_webiny_skill", {
+          title: "Get Webiny Skill",
+          description: "Loads the full Webiny documentation for a specific skill. " + "Call list_webiny_skills first to see available skill names.",
+          inputSchema: {
+            topic: z.string().describe("Skill name — use exact names from list_webiny_skills")
+          },
+          annotations: {
+            readOnlyHint: true
+          }
+        }, async ({
+          topic
+        }) => {
+          const skills = getSkills();
+          const skill = skills.get(topic);
+          if (!skill) {
+            const available = [...skills.keys()].sort();
+            return {
+              content: [{
+                type: "text",
+                text: `Skill not found: "${topic}".\n\n` + `Available skills: ${available.join(", ") || "(none)"}.`
+              }],
+              isError: true
+            };
+          }
+          return {
+            content: [{
+              type: "text",
+              text: readSkillContent(skill)
+            }]
+          };
+        });
+
+        // ---------------------------------------------------------------
+        // Start
+        // ---------------------------------------------------------------
+
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error("[webiny-mcp] server ready");
+      }
+    };
+  }
+}
+export default CliCommandFactory.createImplementation({
+  implementation: McpServerCommand,
+  dependencies: []
+});
+
+//# sourceMappingURL=McpServer.js.map

package/cli/McpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["readFileSync","readdirSync","existsSync","join","resolve","dirname","fileURLToPath","createRequire","fm","z","McpServer","StdioServerTransport","CliCommandFactory","__dirname","import","meta","url","findSkillFiles","dir","results","entry","withFileTypes","fullPath","name","isDirectory","push","isFile","discoverSkills","skillsDirs","skills","Map","filePath","raw","parsed","description","attributes","console","error","has","context","set","err","getVersion","version","buildCatalog","lines","size","contextDescriptions","groups","skill","values","list","get","contextSkills","entries","sort","a","b","localeCompare","desc","skillDesc","replace","trim","readSkillContent","body","McpServerCommand","execute","examples","options","type","array","handler","params","cwd","process","builtInSkillsDir","skillsOverride","additionalSkillsDirs","baseDir","map","p","reverse","d","skillsCache","getSkills","server","registerTool","title","inputSchema","annotations","readOnlyHint","content","text","topic","string","describe","available","keys","isError","transport","connect","createImplementation","implementation","dependencies"],"sources":["McpServer.ts"],"sourcesContent":["import { readFileSync, readdirSync, existsSync } from \"fs\";\nimport { join, resolve, dirname } from \"path\";\nimport { fileURLToPath } from \"url\";\nimport { createRequire } from \"module\";\nimport fm from \"front-matter\";\nimport { z } from \"zod\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { CliCommandFactory } from \"@webiny/cli-core/exports/cli/command.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport interface IMcpServerParams {\n    skills: string;\n    \"additional-skills\": string[];\n}\n\n// ---------------------------------------------------------------------------\n// Skill discovery\n// ---------------------------------------------------------------------------\n\ninterface SkillAttributes {\n    name: string;\n    description: string;\n    context?: string;\n}\n\ninterface Skill {\n    name: string;\n    description: string;\n    context: string;\n    filePath: string;\n}\n\n/**\n * Recursively find all SKILL.md files under `dir`.\n */\nfunction findSkillFiles(dir: string): string[] {\n    if (!existsSync(dir)) {\n        return [];\n    }\n    const results: string[] = [];\n    for (const entry of readdirSync(dir, { withFileTypes: true })) {\n        const fullPath = join(dir, entry.name);\n        if (entry.isDirectory()) {\n            results.push(...findSkillFiles(fullPath));\n        } else if (entry.isFile() && entry.name === \"SKILL.md\") {\n            results.push(fullPath);\n        }\n    }\n    return results;\n}\n\n/**\n * Discover skills from multiple directories. First match wins (higher-priority dirs first).\n */\nfunction discoverSkills(skillsDirs: string[]): Map<string, Skill> {\n    const skills = new Map<string, Skill>();\n\n    for (const dir of skillsDirs) {\n        for (const filePath of findSkillFiles(dir)) {\n            try {\n                const raw = readFileSync(filePath, \"utf8\");\n                const parsed = fm<SkillAttributes>(raw);\n                const { name, description } = parsed.attributes;\n\n                if (!name || !description) {\n                    console.error(`[webiny-mcp] skipping ${filePath}: missing name or description`);\n                    continue;\n                }\n\n                if (!skills.has(name)) {\n                    const context = parsed.attributes.context || \"webiny-extensions\";\n                    skills.set(name, { name, description, context, filePath });\n                }\n            } catch (err) {\n                console.error(`[webiny-mcp] error reading ${filePath}:`, err);\n            }\n        }\n    }\n\n    return skills;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction getVersion(): string {\n    try {\n        return createRequire(import.meta.url)(\"../../package.json\").version;\n    } catch {\n        return \"0.0.0\";\n    }\n}\n\nfunction buildCatalog(skills: Map<string, Skill>): string {\n    const lines: string[] = [`# Webiny Skills  (v${getVersion()})`, \"\"];\n\n    if (skills.size === 0) {\n        lines.push(\n            \"_(No skills found. Add SKILL.md files with front-matter to a skills directory.)_\"\n        );\n        return lines.join(\"\\n\");\n    }\n\n    // Group skills by context.\n    const contextDescriptions: Record<string, string> = {\n        \"webiny-extensions\":\n            \"Use these skills when writing Webiny extensions (usually in `extensions/`) or making changes to `webiny.config.tsx` (user project development).\",\n        \"webiny-packages\":\n            \"Use these skills when writing code in `packages/` (core Webiny framework development).\"\n    };\n\n    const groups = new Map<string, Skill[]>();\n    for (const skill of skills.values()) {\n        const list = groups.get(skill.context) || [];\n        list.push(skill);\n        groups.set(skill.context, list);\n    }\n\n    for (const [context, contextSkills] of [...groups.entries()].sort((a, b) =>\n        a[0].localeCompare(b[0])\n    )) {\n        lines.push(`## ${context}`, \"\");\n        const desc = contextDescriptions[context];\n        if (desc) {\n            lines.push(desc, \"\");\n        }\n        lines.push(\"| Skill | Description |\");\n        lines.push(\"|---|---|\");\n        for (const skill of contextSkills.sort((a, b) => a.name.localeCompare(b.name))) {\n            const skillDesc = skill.description.replace(/\\n/g, \" \").trim();\n            lines.push(`| \\`${skill.name}\\` | ${skillDesc} |`);\n        }\n        lines.push(\"\");\n    }\n\n    return lines.join(\"\\n\");\n}\n\nfunction readSkillContent(skill: Skill): string {\n    const raw = readFileSync(skill.filePath, \"utf8\");\n    return fm(raw).body;\n}\n\n// ---------------------------------------------------------------------------\n// CLI Command\n// ---------------------------------------------------------------------------\n\nclass McpServerCommand implements CliCommandFactory.Interface<IMcpServerParams> {\n    execute(): CliCommandFactory.CommandDefinition<IMcpServerParams> {\n        return {\n            name: \"mcp-server\",\n            description: \"Start the Webiny MCP server (stdio transport).\",\n            examples: [\n                \"$0 mcp-server\",\n                \"$0 mcp-server --skills=./my-skills\",\n                \"$0 mcp-server --additional-skills=./extra-skills\"\n            ],\n            options: [\n                {\n                    name: \"skills\",\n                    description:\n                        \"Replace the built-in skills folder entirely. Only skills found in the given path will be served.\",\n                    type: \"string\"\n                },\n                {\n                    name: \"additional-skills\",\n                    description:\n                        \"Add a folder on top of the built-in (or --skills) folder. Can be repeated.\",\n                    type: \"string\",\n                    array: true\n                }\n            ],\n            handler: async params => {\n                const cwd = process.cwd();\n                const builtInSkillsDir = join(__dirname, \"..\", \"skills\");\n                const skillsOverride = params.skills;\n                const additionalSkillsDirs = params[\"additional-skills\"] || [];\n\n                const baseDir = skillsOverride ? resolve(cwd, skillsOverride) : builtInSkillsDir;\n\n                // skillsDirs[0] = highest priority, skillsDirs[last] = lowest priority\n                const skillsDirs = [\n                    ...[...additionalSkillsDirs].map(p => resolve(cwd, p)).reverse(),\n                    baseDir\n                ];\n\n                if (skillsOverride) {\n                    console.error(`[webiny-mcp] skills override: ${baseDir}`);\n                }\n                for (const d of additionalSkillsDirs) {\n                    console.error(`[webiny-mcp] additional skills: ${resolve(cwd, d)}`);\n                }\n\n                // In-memory cache: populated on first list, reused by get.\n                let skillsCache: Map<string, Skill> | null = null;\n\n                function getSkills(): Map<string, Skill> {\n                    if (!skillsCache) {\n                        skillsCache = discoverSkills(skillsDirs);\n                        console.error(`[webiny-mcp] discovered ${skillsCache.size} skill(s)`);\n                    }\n                    return skillsCache;\n                }\n\n                // ---------------------------------------------------------------\n                // MCP server\n                // ---------------------------------------------------------------\n\n                const server = new McpServer({ name: \"webiny\", version: getVersion() });\n\n                server.registerTool(\n                    \"list_webiny_skills\",\n                    {\n                        title: \"List Webiny Skills\",\n                        description:\n                            \"Returns a catalog of all available Webiny skills with names and descriptions. \" +\n                            \"Always call this first when working on anything Webiny-related, then call \" +\n                            \"get_webiny_skill to load the specific skill you need.\",\n                        inputSchema: {},\n                        annotations: { readOnlyHint: true }\n                    },\n                    async () => ({\n                        content: [{ type: \"text\", text: buildCatalog(getSkills()) }]\n                    })\n                );\n\n                // @ts-expect-error Incompatible Zod version\n                server.registerTool(\n                    \"get_webiny_skill\",\n                    {\n                        title: \"Get Webiny Skill\",\n                        description:\n                            \"Loads the full Webiny documentation for a specific skill. \" +\n                            \"Call list_webiny_skills first to see available skill names.\",\n                        inputSchema: {\n                            topic: z\n                                .string()\n                                .describe(\"Skill name — use exact names from list_webiny_skills\")\n                        },\n                        annotations: { readOnlyHint: true }\n                    },\n                    async ({ topic }) => {\n                        const skills = getSkills();\n                        const skill = skills.get(topic);\n                        if (!skill) {\n                            const available = [...skills.keys()].sort();\n                            return {\n                                content: [\n                                    {\n                                        type: \"text\",\n                                        text:\n                                            `Skill not found: \"${topic}\".\\n\\n` +\n                                            `Available skills: ${available.join(\", \") || \"(none)\"}.`\n                                    }\n                                ],\n                                isError: true\n                            };\n                        }\n                        return {\n                            content: [{ type: \"text\", text: readSkillContent(skill) }]\n                        };\n                    }\n                );\n\n                // ---------------------------------------------------------------\n                // Start\n                // ---------------------------------------------------------------\n\n                const transport = new StdioServerTransport();\n                await server.connect(transport);\n                console.error(\"[webiny-mcp] server ready\");\n            }\n        };\n    }\n}\n\nexport default CliCommandFactory.createImplementation({\n    implementation: McpServerCommand,\n    dependencies: []\n});\n"],"mappings":"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","ignoreList":[]}

package/index.d.ts

@@ -0,0 +1 @@
+export { McpExtension } from "./Extension.js";

package/index.js

@@ -0,0 +1,3 @@
+export { McpExtension } from "./Extension.js";
+
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["McpExtension"],"sources":["index.ts"],"sourcesContent":["export { McpExtension } from \"./Extension.js\";\n"],"mappings":"AAAA,SAASA,YAAY","ignoreList":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "@webiny/mcp",
+	"version": "0.0.0-unstable.6844005670",
+	"type": "module",
+	"main": "./index.js",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/webiny/webiny-js.git"
+	},
+	"description": "Webiny Model Context Protocol (MCP) server.",
+	"author": "Webiny Ltd",
+	"license": "MIT",
+	"publishConfig": {
+		"access": "public",
+		"directory": "dist"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "1.27.1",
+		"@webiny/cli-core": "0.0.0-unstable.6844005670",
+		"front-matter": "4.0.2",
+		"react": "18.2.0",
+		"zod": "3.25.76"
+	},
+	"devDependencies": {
+		"@types/lodash": "4.17.24",
+		"@types/ncp": "2.0.8",
+		"@webiny/build-tools": "0.0.0-unstable.6844005670",
+		"typescript": "5.9.3"
+	},
+	"scripts": {
+		"prepublishOnly": "cp -R ../../skills/user-skills ./dist/skills"
+	},
+	"adio": {
+		"ignoreDirs": [
+			"_templates"
+		],
+		"ignore": {
+			"src": [
+				"listr2",
+				"cloudfront"
+			],
+			"dependencies": [
+				"@pulumi/pulumi",
+				"@pulumi/aws"
+			]
+		}
+	},
+	"gitHead": "6844005670e84a575d0c765a6c4f9c5d59166516"
+}