@nyuchi/mzizi-mcp 0.12.0 → 0.14.0

package/dist/server.js

@@ -11,13 +11,15 @@
  * carrying its `replaces` list in `TOOL_COVERAGE`, and the `docs_*` tools mirror
  * whatever the docs server lists.
  */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/server";
+import { BUNDLED_SKILLS, SKILLS_VERSION } from "./generated/skills.js";
+import { skillFileUri, skillUri } from "./tools.js";
 import { REGISTRY_PIN as REGISTRY_PIN_INFO } from "./generated/registry-pin.js";
 import { registerDocsTools, DOCS_MCP_URL } from "./docs-federation.js";
 import { registerMziziTools, TOOL_COVERAGE, TOOL_PREFIX } from "./tools.js";
 import { jsonContent } from "./tool-result.js";
 import { accessFor, accessSummary } from "./access.js";
-export const MZIZI_MCP_VERSION = "0.12.0";
+export const MZIZI_MCP_VERSION = "0.14.0";
 /**
  * What this server exposes, computed from what was actually registered.
  *
@@ -37,6 +39,21 @@ export function describeTools(registered) {
         },
         note: "Registry data and skills are files bundled into this build at a pinned commit. Components are Rust first: each Mzizi Roots (Rust) implementation, with its crate and contract, comes from the registry's /v1/rs route and leads mzizi_get_component; the React build follows. docs_* tools are forwarded to the docs.mzizi.dev MCP. This server holds no database credential.",
         access: accessSummary(registered),
+        // The skill set, read from the bundle this build carries: the same list
+        // mzizi_get_skills, the skill resources and the skill prompts serve.
+        skills: {
+            version: SKILLS_VERSION,
+            tool: `${TOOL_PREFIX}get_skills`,
+            resources: "mzizi://skills/{name} (SKILL.md) and mzizi://skills/{name}/{path} (the files it ships)",
+            prompts: "skill-{name}",
+            list: BUNDLED_SKILLS.map((s) => ({
+                name: s.name,
+                category: s.category,
+                uri: skillUri(s.name),
+                prompt: `skill-${s.name}`,
+                files: s.files.map((f) => f.path),
+            })),
+        },
         tools: registered.map((name) => ({
             name: name.startsWith("docs_") ? name : `${TOOL_PREFIX}${name}`,
             access: accessFor(name),
@@ -66,6 +83,80 @@ export async function mziziToolCatalogue(opts = {}) {
     // tool not declared in `tools.ts`.
     return describeTools([...registered, "mcp_describe", ...docs]);
 }
+/**
+ * The skills as MCP resources and prompts, beside `mzizi_get_skills`, so a
+ * client that never calls tools (or never installs the Claude Code plugin)
+ * gets the same skills: each SKILL.md as `mzizi://skills/<name>`, each file a
+ * skill ships as `mzizi://skills/<name>/<path>`, and each skill as the prompt
+ * `skill-<name>`, whose message is the skill's full text. All three read
+ * BUNDLED_SKILLS, so they cannot disagree with the tool.
+ */
+export function registerSkillSurfaces(server) {
+    server.registerResource("mzizi-skill", new ResourceTemplate("mzizi://skills/{name}", {
+        list: async () => ({
+            resources: BUNDLED_SKILLS.map((s) => ({
+                uri: skillUri(s.name),
+                name: s.name,
+                title: `Skill: ${s.name}`,
+                description: s.description,
+                mimeType: "text/markdown",
+            })),
+        }),
+    }), {
+        title: "Mzizi agent skill",
+        description: `A Mzizi agent skill's SKILL.md body (@nyuchi/mzizi-skills ${SKILLS_VERSION}).`,
+        mimeType: "text/markdown",
+    }, async (uri, { name }) => {
+        const skill = BUNDLED_SKILLS.find((s) => s.name === String(name));
+        if (!skill)
+            throw new Error(`No skill named "${String(name)}".`);
+        return { contents: [{ uri: uri.href, mimeType: "text/markdown", text: skill.body_mdx }] };
+    });
+    server.registerResource("mzizi-skill-file", new ResourceTemplate("mzizi://skills/{name}/{+path}", {
+        list: async () => ({
+            resources: BUNDLED_SKILLS.flatMap((s) => s.files.map((f) => ({
+                uri: skillFileUri(s.name, f.path),
+                name: `${s.name}/${f.path}`,
+                title: `${s.name}: ${f.path}`,
+                mimeType: f.mimeType,
+            }))),
+        }),
+    }), {
+        title: "A file a Mzizi skill ships",
+        description: "A script, stylesheet, data file or image shipped beside a skill's SKILL.md, byte for byte (images as base64 blobs).",
+    }, async (uri, { name, path }) => {
+        const skill = BUNDLED_SKILLS.find((s) => s.name === String(name));
+        const file = skill?.files.find((f) => f.path === String(path));
+        if (!skill || !file)
+            throw new Error(`No file "${String(path)}" in skill "${String(name)}".`);
+        // A binary file (PNG, ICO) is a blob resource, base64 as MCP specifies.
+        return {
+            contents: [
+                file.encoding === "base64"
+                    ? { uri: uri.href, mimeType: file.mimeType, blob: file.content }
+                    : { uri: uri.href, mimeType: file.mimeType, text: file.content },
+            ],
+        };
+    });
+    for (const skill of BUNDLED_SKILLS) {
+        server.registerPrompt(`skill-${skill.name}`, { title: `Load the ${skill.name} skill`, description: skill.description }, async () => ({
+            description: skill.description,
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Follow the Mzizi skill "${skill.name}" (@nyuchi/mzizi-skills ${SKILLS_VERSION}) for this task.` +
+                            (skill.files.length
+                                ? ` It ships ${skill.files.map((f) => f.path).join(", ")}, readable as ${skillFileUri(skill.name, "<path>")} or with mzizi_get_skills name=${skill.name} file=<path>.`
+                                : "") +
+                            `\n\n${skill.body_mdx}`,
+                    },
+                },
+            ],
+        }));
+    }
+}
 export async function createMziziMcpServer(opts = {}) {
     const server = new McpServer({
         name: "mzizi-mcp",
@@ -75,6 +166,7 @@ export async function createMziziMcpServer(opts = {}) {
         capabilities: {
             tools: { listChanged: true },
             resources: { listChanged: true },
+            prompts: { listChanged: true },
         },
         instructions: "Access to the Mzizi design system: components, design tokens, brand, the DNA-helix architecture, Ubuntu doctrine and conventions, agent skills and releases (the mzizi_* tools, served from files bundled at a pinned registry commit), plus the documentation site (the docs_* tools, forwarded to docs.mzizi.dev). Start with mzizi_search if you do not know the name of what you want; mzizi_get_component returns a component in full in one read, Rust first: where a Mzizi Roots (Rust) implementation exists it leads with the crate, the cargo add line, the contract and the .rs source, and gives the React build second (deprioritised); mzizi_list_components and mzizi_search mark those components with rustCrate; mzizi_get_architecture returns the helix and takes an uncapped node number; docs_search_mzizi searches the documentation. Every tool is free without an account except mzizi_fundi and mzizi_report_issue, which act as your Mzizi console user and need sign-in; called without it they say how to sign in.",
     });
@@ -100,6 +192,7 @@ export async function createMziziMcpServer(opts = {}) {
             },
         ],
     }));
+    registerSkillSurfaces(server);
     // Registered here rather than in `tools.ts` because it closes over `describe`,
     // but it still has to land in `registered` — otherwise every catalogue surface
     // reports one tool fewer than the server actually answers to.
@@ -107,7 +200,7 @@ export async function createMziziMcpServer(opts = {}) {
     server.registerTool(`${TOOL_PREFIX}mcp_describe`, {
         title: "Describe this server",
         description: "What this MCP server exposes: its tools, which are free and which need sign-in, what each replaces, and where its data comes from.",
-        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     }, async () => jsonContent(describe()));
     // Last, so the describe tool and resource report them too: `describe` reads
     // `registered` when called, not when defined.

package/dist/server.js.map

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

package/dist/stdio.js

@@ -11,12 +11,13 @@
  * `MZIZI_API_BASE` is gone: there is no registry API to point at any more. To
  * serve different registry content, build with a different pin.
  */
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
 import { createMziziMcpServer } from "./server.js";
+// The SDK's stdio entry: it builds a server from the factory for the
+// connection (and for any `server/discover` probe), so 2026-07-28 and
+// 2025-era clients are both served. Nothing here writes to stdout.
 async function main() {
-    const server = await createMziziMcpServer();
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
+    serveStdio(() => createMziziMcpServer());
 }
 main().catch((err) => {
     const message = err instanceof Error ? (err.stack ?? err.message) : String(err);

package/dist/stdio.js.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,oBAAoB,EAAE,CAAA;IAC3C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC/E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,OAAO,IAAI,CAAC,CAAA;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,qEAAqE;AACrE,sEAAsE;AACtE,mEAAmE;AACnE,KAAK,UAAU,IAAI;IACjB,UAAU,CAAC,GAAG,EAAE,CAAC,oBAAoB,EAAE,CAAC,CAAA;AAC1C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC/E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,OAAO,IAAI,CAAC,CAAA;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/tools.d.ts

@@ -20,9 +20,29 @@
  * mzizi repo. Each tool's `replaces` list is recorded on the definition so coverage can
  * be checked mechanically rather than argued about.
  */
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpServer } from "@modelcontextprotocol/server";
 import { type Registry } from "./registry.js";
 import type { FundiToolContext } from "./fundi-client.js";
+import { type BundledSkill } from "./generated/skills.js";
+/** The MCP resource URI of a skill's SKILL.md body, and of a file it ships. */
+export declare const skillUri: (name: string) => string;
+export declare const skillFileUri: (name: string, path: string) => string;
+/** A skill as the tool returns it: the body in full, its files as a list (content on request). */
+export declare function skillView(skill: BundledSkill): {
+    uri: string;
+    files: {
+        path: string;
+        mimeType: string;
+        bytes: number;
+        encoding: "base64" | "utf8";
+        uri: string;
+    }[];
+    name: string;
+    category: import("./generated/skills.js").SkillCategory;
+    description: string;
+    body_mdx: string;
+    source: string;
+};
 export declare const TOOL_PREFIX = "mzizi_";
 /** What each tool absorbed, so coverage against the old 62 is checkable. */
 export declare const TOOL_COVERAGE: Record<string, readonly string[]>;

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAmC,KAAK,QAAQ,EAA8B,MAAM,eAAe,CAAC;AAC3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAW1D,eAAO,MAAM,WAAW,WAAW,CAAC;AAmEpC,4EAA4E;AAC5E,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CA0D3D,CAAC;AAoDF;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,KAAK,EAAE;QACV,IAAI,EAAE,UAAU,GAAG,eAAe,GAAG,OAAO,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,mFAAmF;IACnF,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CAChC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,eAAe,GACpB,MAAM,EAAE,CAimBV"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAmC,KAAK,QAAQ,EAA8B,MAAM,eAAe,CAAC;AAC3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAU1D,OAAO,EAAoD,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE5G,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,WAA6B,CAAC;AACnE,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,WAAqC,CAAC;AAE7F,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY;;;;;;;;;;;;;;EAO5C;AAED,eAAO,MAAM,WAAW,WAAW,CAAC;AAwEpC,4EAA4E;AAC5E,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CA0D3D,CAAC;AAkLF;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,KAAK,EAAE;QACV,IAAI,EAAE,UAAU,GAAG,eAAe,GAAG,OAAO,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,mFAAmF;IACnF,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CAChC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,eAAe,GACpB,MAAM,EAAE,CAiuBV"}