@skills-hub-ai/mcp 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @skills-hub-ai/mcp@0.1.0 build /Users/thole/personal/skills-hub/apps/mcp
+> tsc
+

package/.turbo/turbo-test.log

@@ -0,0 +1,15 @@
+
+> @skills-hub-ai/mcp@0.1.0 test /Users/thole/personal/skills-hub/apps/mcp
+> vitest run --passWithNoTests
+
+
+ RUN  v2.1.9 /Users/thole/personal/skills-hub/apps/mcp
+
+ ✓ src/index.test.ts (6 tests) 582ms
+ ✓ src/discover.test.ts (8 tests) 8ms
+
+ Test Files  2 passed (2)
+      Tests  14 passed (14)
+   Start at  17:33:09
+   Duration  3.22s (transform 1.41s, setup 0ms, collect 1.91s, tests 590ms, environment 0ms, prepare 611ms)
+

package/dist/discover.d.ts

@@ -0,0 +1,6 @@
+import { type ParsedSkill } from "@skills-hub/skill-parser";
+/** Discover all installed skills, cached for 30s */
+export declare function discoverSkills(): Map<string, ParsedSkill>;
+/** Clear the discovery cache (for testing) */
+export declare function clearCache(): void;
+//# sourceMappingURL=discover.d.ts.map

package/dist/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA0C1E,oDAAoD;AACpD,wBAAgB,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAczD;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}

package/dist/discover.js

@@ -0,0 +1,61 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { parseSkillMd } from "@skills-hub/skill-parser";
+const CACHE_TTL_MS = 30_000;
+let cache = null;
+let cacheTime = 0;
+/** Directories where skills may be installed */
+function getSkillPaths() {
+    const home = homedir();
+    return [
+        join(home, ".claude", "skills"),
+        join(home, ".cursor", "skills"),
+    ];
+}
+/** Scan a single skills directory and collect parsed skills */
+function scanDir(dir, out) {
+    if (!existsSync(dir))
+        return;
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const slug = entry.name;
+        if (out.has(slug))
+            continue; // first-found wins (claude > cursor)
+        const skillFile = join(dir, slug, "SKILL.md");
+        if (!existsSync(skillFile))
+            continue;
+        try {
+            const content = readFileSync(skillFile, "utf-8");
+            const result = parseSkillMd(content);
+            if (result.success && result.skill) {
+                out.set(slug, result.skill);
+            }
+        }
+        catch {
+            // Skip malformed files
+        }
+    }
+}
+/** Discover all installed skills, cached for 30s */
+export function discoverSkills() {
+    const now = Date.now();
+    if (cache && now - cacheTime < CACHE_TTL_MS) {
+        return cache;
+    }
+    const skills = new Map();
+    for (const dir of getSkillPaths()) {
+        scanDir(dir, skills);
+    }
+    cache = skills;
+    cacheTime = now;
+    return skills;
+}
+/** Clear the discovery cache (for testing) */
+export function clearCache() {
+    cache = null;
+    cacheTime = 0;
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,YAAY,EAAoB,MAAM,0BAA0B,CAAC;AAE1E,MAAM,YAAY,GAAG,MAAM,CAAC;AAE5B,IAAI,KAAK,GAAoC,IAAI,CAAC;AAClD,IAAI,SAAS,GAAG,CAAC,CAAC;AAElB,gDAAgD;AAChD,SAAS,aAAa;IACpB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC;QAC/B,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,SAAS,OAAO,CAAC,GAAW,EAAE,GAA6B;IACzD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO;IAE7B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QAEnC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,qCAAqC;QAElE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,SAAS;QAErC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACrC,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACnC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,KAAK,IAAI,GAAG,GAAG,SAAS,GAAG,YAAY,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,GAAG,MAAM,CAAC;IACf,SAAS,GAAG,GAAG,CAAC;IAChB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,UAAU;IACxB,KAAK,GAAG,IAAI,CAAC;IACb,SAAS,GAAG,CAAC,CAAC;AAChB,CAAC"}

package/dist/discover.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=discover.test.d.ts.map

package/dist/discover.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.test.d.ts","sourceRoot":"","sources":["../src/discover.test.ts"],"names":[],"mappings":""}

package/dist/discover.test.js

@@ -0,0 +1,129 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+vi.mock("node:fs", () => ({
+    existsSync: vi.fn(() => false),
+    readdirSync: vi.fn(() => []),
+    readFileSync: vi.fn(() => ""),
+}));
+vi.mock("node:os", () => ({
+    homedir: vi.fn(() => "/home/user"),
+}));
+import { discoverSkills, clearCache } from "./discover.js";
+const mockExistsSync = vi.mocked(existsSync);
+const mockReaddirSync = vi.mocked(readdirSync);
+const mockReadFileSync = vi.mocked(readFileSync);
+const validSkillMd = `---
+name: Code Review
+description: Automated code review for quality and best practices
+version: 1.0.0
+---
+
+Review the code carefully and suggest improvements.
+`;
+const anotherSkillMd = `---
+name: Security Scan
+description: Scan code for security vulnerabilities and common exploits
+version: 2.0.0
+---
+
+Check for OWASP top 10 vulnerabilities.
+`;
+function makeDirent(name) {
+    return { name, isDirectory: () => true, isFile: () => false };
+}
+beforeEach(() => {
+    vi.clearAllMocks();
+    clearCache();
+});
+describe("discoverSkills", () => {
+    it("discovers skills from claude skills directory", () => {
+        mockExistsSync.mockImplementation((p) => {
+            const s = String(p);
+            return s === "/home/user/.claude/skills" || s.endsWith("SKILL.md");
+        });
+        mockReaddirSync.mockReturnValue([makeDirent("code-review")]);
+        mockReadFileSync.mockReturnValue(validSkillMd);
+        const skills = discoverSkills();
+        expect(skills.size).toBe(1);
+        expect(skills.has("code-review")).toBe(true);
+        expect(skills.get("code-review").name).toBe("Code Review");
+        expect(skills.get("code-review").instructions).toContain("Review the code carefully");
+    });
+    it("discovers skills from cursor skills directory", () => {
+        mockExistsSync.mockImplementation((p) => {
+            const s = String(p);
+            return s === "/home/user/.cursor/skills" || s.endsWith("SKILL.md");
+        });
+        mockReaddirSync.mockReturnValue([makeDirent("security-scan")]);
+        mockReadFileSync.mockReturnValue(anotherSkillMd);
+        const skills = discoverSkills();
+        expect(skills.size).toBe(1);
+        expect(skills.has("security-scan")).toBe(true);
+    });
+    it("scans both directories and deduplicates by slug", () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReaddirSync.mockImplementation((dir) => {
+            const s = String(dir);
+            if (s.includes(".claude"))
+                return [makeDirent("code-review")];
+            if (s.includes(".cursor"))
+                return [makeDirent("code-review"), makeDirent("security-scan")];
+            return [];
+        });
+        mockReadFileSync.mockImplementation((p) => {
+            const s = String(p);
+            if (s.includes("code-review"))
+                return validSkillMd;
+            if (s.includes("security-scan"))
+                return anotherSkillMd;
+            return "";
+        });
+        const skills = discoverSkills();
+        // code-review from claude wins (first-found), security-scan from cursor
+        expect(skills.size).toBe(2);
+        expect(skills.has("code-review")).toBe(true);
+        expect(skills.has("security-scan")).toBe(true);
+    });
+    it("handles missing skills directories", () => {
+        mockExistsSync.mockReturnValue(false);
+        const skills = discoverSkills();
+        expect(skills.size).toBe(0);
+    });
+    it("skips directories without SKILL.md", () => {
+        mockExistsSync.mockImplementation((p) => {
+            const s = String(p);
+            // Directory exists but SKILL.md does not
+            return s === "/home/user/.claude/skills";
+        });
+        mockReaddirSync.mockReturnValue([makeDirent("orphan-dir")]);
+        const skills = discoverSkills();
+        expect(skills.size).toBe(0);
+    });
+    it("skips malformed SKILL.md files", () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReaddirSync.mockReturnValue([makeDirent("bad-skill")]);
+        mockReadFileSync.mockReturnValue("this is not valid frontmatter");
+        const skills = discoverSkills();
+        expect(skills.size).toBe(0);
+    });
+    it("caches results for subsequent calls", () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReaddirSync.mockReturnValue([makeDirent("code-review")]);
+        mockReadFileSync.mockReturnValue(validSkillMd);
+        discoverSkills();
+        discoverSkills();
+        // readdirSync called once per directory on first call, not on second
+        expect(mockReaddirSync).toHaveBeenCalledTimes(2); // once for claude, once for cursor
+    });
+    it("re-scans after cache is cleared", () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReaddirSync.mockReturnValue([makeDirent("code-review")]);
+        mockReadFileSync.mockReturnValue(validSkillMd);
+        discoverSkills();
+        clearCache();
+        discoverSkills();
+        // 2 dirs × 2 scans = 4 calls
+        expect(mockReaddirSync).toHaveBeenCalledTimes(4);
+    });
+});
+//# sourceMappingURL=discover.test.js.map

package/dist/discover.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListPromptsRequestSchema, GetPromptRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { discoverSkills } from "./discover.js";
+const server = new Server({ name: "skills-hub", version: "0.1.0" }, { capabilities: { prompts: { listChanged: true } } });
+server.setRequestHandler(ListPromptsRequestSchema, async () => {
+    const skills = discoverSkills();
+    return {
+        prompts: Array.from(skills.entries()).map(([slug, skill]) => ({
+            name: slug,
+            description: skill.description,
+            arguments: [
+                {
+                    name: "input",
+                    description: "Context or instructions for the skill",
+                    required: false,
+                },
+            ],
+        })),
+    };
+});
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const skills = discoverSkills();
+    const skill = skills.get(name);
+    if (!skill) {
+        throw new McpError(ErrorCode.InvalidRequest, `Unknown skill: ${name}. Run "skills-hub install ${name}" to install it.`);
+    }
+    let text = skill.instructions;
+    if (args?.input) {
+        text += `\n\n${args.input}`;
+    }
+    return {
+        description: skill.description,
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text },
+            },
+        ],
+    };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // stderr only — stdout is the MCP JSON-RPC stream
+    console.error("skills-hub MCP server running");
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,SAAS,EACT,QAAQ,GACT,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,EACxC,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,CACrD,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;IAC5D,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAEhC,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5D,IAAI,EAAE,IAAI;YACV,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE;gBACT;oBACE,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,uCAAuC;oBACpD,QAAQ,EAAE,KAAK;iBAChB;aACF;SACF,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACjE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,kBAAkB,IAAI,6BAA6B,IAAI,kBAAkB,CAC1E,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC;IAC9B,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;QAChB,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE;aACzC;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,kDAAkD;IAClD,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;AACjD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/dist/index.test.js

@@ -0,0 +1,138 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+vi.mock("./discover.js", () => ({
+    discoverSkills: vi.fn(),
+}));
+// Mock the MCP SDK — we test the handler logic, not the transport
+vi.mock("@modelcontextprotocol/sdk/server/index.js", () => {
+    const handlers = new Map();
+    return {
+        Server: vi.fn().mockImplementation(() => ({
+            setRequestHandler: vi.fn((schema, handler) => {
+                handlers.set(schema.method, handler);
+            }),
+            connect: vi.fn(),
+            _handlers: handlers,
+        })),
+    };
+});
+vi.mock("@modelcontextprotocol/sdk/server/stdio.js", () => ({
+    StdioServerTransport: vi.fn(),
+}));
+vi.mock("@modelcontextprotocol/sdk/types.js", () => ({
+    ListPromptsRequestSchema: { method: "prompts/list" },
+    GetPromptRequestSchema: { method: "prompts/get" },
+    ErrorCode: { InvalidRequest: -32600 },
+    McpError: class McpError extends Error {
+        code;
+        constructor(code, message) {
+            super(message);
+            this.code = code;
+        }
+    },
+}));
+import { discoverSkills } from "./discover.js";
+const mockDiscoverSkills = vi.mocked(discoverSkills);
+function makeSkill(name, description, instructions) {
+    return {
+        name,
+        description,
+        version: "1.0.0",
+        category: undefined,
+        platforms: [],
+        instructions,
+        raw: "",
+    };
+}
+let handlers;
+beforeEach(async () => {
+    vi.clearAllMocks();
+    // Re-import to trigger module-level server creation
+    vi.resetModules();
+    // Re-mock after resetModules
+    vi.doMock("./discover.js", () => ({
+        discoverSkills: mockDiscoverSkills,
+    }));
+    vi.doMock("@modelcontextprotocol/sdk/server/index.js", () => {
+        const h = new Map();
+        handlers = h;
+        return {
+            Server: vi.fn().mockImplementation(() => ({
+                setRequestHandler: vi.fn((schema, handler) => {
+                    h.set(schema.method, handler);
+                }),
+                connect: vi.fn(),
+            })),
+        };
+    });
+    vi.doMock("@modelcontextprotocol/sdk/server/stdio.js", () => ({
+        StdioServerTransport: vi.fn(),
+    }));
+    vi.doMock("@modelcontextprotocol/sdk/types.js", () => ({
+        ListPromptsRequestSchema: { method: "prompts/list" },
+        GetPromptRequestSchema: { method: "prompts/get" },
+        ErrorCode: { InvalidRequest: -32600 },
+        McpError: class McpError extends Error {
+            code;
+            constructor(code, message) {
+                super(message);
+                this.code = code;
+            }
+        },
+    }));
+    // Suppress console.error from main()
+    vi.spyOn(console, "error").mockImplementation(() => { });
+    await import("./index.js");
+});
+describe("MCP server", () => {
+    it("registers prompts/list and prompts/get handlers", () => {
+        expect(handlers.has("prompts/list")).toBe(true);
+        expect(handlers.has("prompts/get")).toBe(true);
+    });
+    it("listPrompts returns discovered skills", async () => {
+        const skills = new Map();
+        skills.set("code-review", makeSkill("Code Review", "Review code quality", "Review carefully"));
+        skills.set("security-scan", makeSkill("Security Scan", "Find vulnerabilities", "Check OWASP"));
+        mockDiscoverSkills.mockReturnValue(skills);
+        const handler = handlers.get("prompts/list");
+        const result = (await handler({}));
+        expect(result.prompts).toHaveLength(2);
+        expect(result.prompts[0].name).toBe("code-review");
+        expect(result.prompts[0].description).toBe("Review code quality");
+        expect(result.prompts[1].name).toBe("security-scan");
+    });
+    it("listPrompts returns empty array when no skills installed", async () => {
+        mockDiscoverSkills.mockReturnValue(new Map());
+        const handler = handlers.get("prompts/list");
+        const result = (await handler({}));
+        expect(result.prompts).toEqual([]);
+    });
+    it("getPrompt returns skill instructions", async () => {
+        const skills = new Map();
+        skills.set("code-review", makeSkill("Code Review", "Review code quality", "Review carefully"));
+        mockDiscoverSkills.mockReturnValue(skills);
+        const handler = handlers.get("prompts/get");
+        const result = (await handler({
+            params: { name: "code-review", arguments: {} },
+        }));
+        expect(result.description).toBe("Review code quality");
+        expect(result.messages).toHaveLength(1);
+        expect(result.messages[0].role).toBe("user");
+        expect(result.messages[0].content.text).toBe("Review carefully");
+    });
+    it("getPrompt appends input argument to instructions", async () => {
+        const skills = new Map();
+        skills.set("code-review", makeSkill("Code Review", "Review code quality", "Review carefully"));
+        mockDiscoverSkills.mockReturnValue(skills);
+        const handler = handlers.get("prompts/get");
+        const result = (await handler({
+            params: { name: "code-review", arguments: { input: "Focus on error handling" } },
+        }));
+        expect(result.messages[0].content.text).toBe("Review carefully\n\nFocus on error handling");
+    });
+    it("getPrompt throws McpError for unknown skill", async () => {
+        mockDiscoverSkills.mockReturnValue(new Map());
+        const handler = handlers.get("prompts/get");
+        await expect(handler({ params: { name: "nonexistent", arguments: {} } })).rejects.toThrow('Unknown skill: nonexistent');
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@skills-hub-ai/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for skills-hub.ai — serve installed skills as prompts in any MCP-compatible AI tool",
+  "license": "MIT",
+  "keywords": ["mcp", "model-context-protocol", "claude-code", "cursor", "skills", "ai", "prompts"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tinh2/skills-hub.git",
+    "directory": "apps/mcp"
+  },
+  "homepage": "https://skills-hub.ai",
+  "type": "module",
+  "bin": {
+    "skills-hub-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@skills-hub/skill-parser": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.0.0"
+  }
+}

package/src/discover.test.ts

@@ -0,0 +1,156 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+
+vi.mock("node:fs", () => ({
+  existsSync: vi.fn(() => false),
+  readdirSync: vi.fn(() => []),
+  readFileSync: vi.fn(() => ""),
+}));
+
+vi.mock("node:os", () => ({
+  homedir: vi.fn(() => "/home/user"),
+}));
+
+import { discoverSkills, clearCache } from "./discover.js";
+
+const mockExistsSync = vi.mocked(existsSync);
+const mockReaddirSync = vi.mocked(readdirSync);
+const mockReadFileSync = vi.mocked(readFileSync);
+
+const validSkillMd = `---
+name: Code Review
+description: Automated code review for quality and best practices
+version: 1.0.0
+---
+
+Review the code carefully and suggest improvements.
+`;
+
+const anotherSkillMd = `---
+name: Security Scan
+description: Scan code for security vulnerabilities and common exploits
+version: 2.0.0
+---
+
+Check for OWASP top 10 vulnerabilities.
+`;
+
+function makeDirent(name: string): ReturnType<typeof readdirSync>[0] {
+  return { name, isDirectory: () => true, isFile: () => false } as unknown as ReturnType<typeof readdirSync>[0];
+}
+
+beforeEach(() => {
+  vi.clearAllMocks();
+  clearCache();
+});
+
+describe("discoverSkills", () => {
+  it("discovers skills from claude skills directory", () => {
+    mockExistsSync.mockImplementation((p) => {
+      const s = String(p);
+      return s === "/home/user/.claude/skills" || s.endsWith("SKILL.md");
+    });
+    mockReaddirSync.mockReturnValue([makeDirent("code-review")]);
+    mockReadFileSync.mockReturnValue(validSkillMd);
+
+    const skills = discoverSkills();
+
+    expect(skills.size).toBe(1);
+    expect(skills.has("code-review")).toBe(true);
+    expect(skills.get("code-review")!.name).toBe("Code Review");
+    expect(skills.get("code-review")!.instructions).toContain("Review the code carefully");
+  });
+
+  it("discovers skills from cursor skills directory", () => {
+    mockExistsSync.mockImplementation((p) => {
+      const s = String(p);
+      return s === "/home/user/.cursor/skills" || s.endsWith("SKILL.md");
+    });
+    mockReaddirSync.mockReturnValue([makeDirent("security-scan")]);
+    mockReadFileSync.mockReturnValue(anotherSkillMd);
+
+    const skills = discoverSkills();
+
+    expect(skills.size).toBe(1);
+    expect(skills.has("security-scan")).toBe(true);
+  });
+
+  it("scans both directories and deduplicates by slug", () => {
+    mockExistsSync.mockReturnValue(true);
+    mockReaddirSync.mockImplementation((dir) => {
+      const s = String(dir);
+      if (s.includes(".claude")) return [makeDirent("code-review")];
+      if (s.includes(".cursor")) return [makeDirent("code-review"), makeDirent("security-scan")];
+      return [];
+    });
+    mockReadFileSync.mockImplementation((p) => {
+      const s = String(p);
+      if (s.includes("code-review")) return validSkillMd;
+      if (s.includes("security-scan")) return anotherSkillMd;
+      return "";
+    });
+
+    const skills = discoverSkills();
+
+    // code-review from claude wins (first-found), security-scan from cursor
+    expect(skills.size).toBe(2);
+    expect(skills.has("code-review")).toBe(true);
+    expect(skills.has("security-scan")).toBe(true);
+  });
+
+  it("handles missing skills directories", () => {
+    mockExistsSync.mockReturnValue(false);
+
+    const skills = discoverSkills();
+
+    expect(skills.size).toBe(0);
+  });
+
+  it("skips directories without SKILL.md", () => {
+    mockExistsSync.mockImplementation((p) => {
+      const s = String(p);
+      // Directory exists but SKILL.md does not
+      return s === "/home/user/.claude/skills";
+    });
+    mockReaddirSync.mockReturnValue([makeDirent("orphan-dir")]);
+
+    const skills = discoverSkills();
+
+    expect(skills.size).toBe(0);
+  });
+
+  it("skips malformed SKILL.md files", () => {
+    mockExistsSync.mockReturnValue(true);
+    mockReaddirSync.mockReturnValue([makeDirent("bad-skill")]);
+    mockReadFileSync.mockReturnValue("this is not valid frontmatter");
+
+    const skills = discoverSkills();
+
+    expect(skills.size).toBe(0);
+  });
+
+  it("caches results for subsequent calls", () => {
+    mockExistsSync.mockReturnValue(true);
+    mockReaddirSync.mockReturnValue([makeDirent("code-review")]);
+    mockReadFileSync.mockReturnValue(validSkillMd);
+
+    discoverSkills();
+    discoverSkills();
+
+    // readdirSync called once per directory on first call, not on second
+    expect(mockReaddirSync).toHaveBeenCalledTimes(2); // once for claude, once for cursor
+  });
+
+  it("re-scans after cache is cleared", () => {
+    mockExistsSync.mockReturnValue(true);
+    mockReaddirSync.mockReturnValue([makeDirent("code-review")]);
+    mockReadFileSync.mockReturnValue(validSkillMd);
+
+    discoverSkills();
+    clearCache();
+    discoverSkills();
+
+    // 2 dirs × 2 scans = 4 calls
+    expect(mockReaddirSync).toHaveBeenCalledTimes(4);
+  });
+});

package/src/discover.ts

@@ -0,0 +1,67 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { parseSkillMd, type ParsedSkill } from "@skills-hub/skill-parser";
+
+const CACHE_TTL_MS = 30_000;
+
+let cache: Map<string, ParsedSkill> | null = null;
+let cacheTime = 0;
+
+/** Directories where skills may be installed */
+function getSkillPaths(): string[] {
+  const home = homedir();
+  return [
+    join(home, ".claude", "skills"),
+    join(home, ".cursor", "skills"),
+  ];
+}
+
+/** Scan a single skills directory and collect parsed skills */
+function scanDir(dir: string, out: Map<string, ParsedSkill>): void {
+  if (!existsSync(dir)) return;
+
+  const entries = readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+
+    const slug = entry.name;
+    if (out.has(slug)) continue; // first-found wins (claude > cursor)
+
+    const skillFile = join(dir, slug, "SKILL.md");
+    if (!existsSync(skillFile)) continue;
+
+    try {
+      const content = readFileSync(skillFile, "utf-8");
+      const result = parseSkillMd(content);
+      if (result.success && result.skill) {
+        out.set(slug, result.skill);
+      }
+    } catch {
+      // Skip malformed files
+    }
+  }
+}
+
+/** Discover all installed skills, cached for 30s */
+export function discoverSkills(): Map<string, ParsedSkill> {
+  const now = Date.now();
+  if (cache && now - cacheTime < CACHE_TTL_MS) {
+    return cache;
+  }
+
+  const skills = new Map<string, ParsedSkill>();
+  for (const dir of getSkillPaths()) {
+    scanDir(dir, skills);
+  }
+
+  cache = skills;
+  cacheTime = now;
+  return skills;
+}
+
+/** Clear the discovery cache (for testing) */
+export function clearCache(): void {
+  cache = null;
+  cacheTime = 0;
+}

package/src/index.test.ts

@@ -0,0 +1,173 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import type { ParsedSkill } from "@skills-hub/skill-parser";
+
+vi.mock("./discover.js", () => ({
+  discoverSkills: vi.fn(),
+}));
+
+// Mock the MCP SDK — we test the handler logic, not the transport
+vi.mock("@modelcontextprotocol/sdk/server/index.js", () => {
+  const handlers = new Map<string, (req: unknown) => Promise<unknown>>();
+  return {
+    Server: vi.fn().mockImplementation(() => ({
+      setRequestHandler: vi.fn((schema: { method: string }, handler: (req: unknown) => Promise<unknown>) => {
+        handlers.set(schema.method, handler);
+      }),
+      connect: vi.fn(),
+      _handlers: handlers,
+    })),
+  };
+});
+
+vi.mock("@modelcontextprotocol/sdk/server/stdio.js", () => ({
+  StdioServerTransport: vi.fn(),
+}));
+
+vi.mock("@modelcontextprotocol/sdk/types.js", () => ({
+  ListPromptsRequestSchema: { method: "prompts/list" },
+  GetPromptRequestSchema: { method: "prompts/get" },
+  ErrorCode: { InvalidRequest: -32600 },
+  McpError: class McpError extends Error {
+    code: number;
+    constructor(code: number, message: string) {
+      super(message);
+      this.code = code;
+    }
+  },
+}));
+
+import { discoverSkills } from "./discover.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+
+const mockDiscoverSkills = vi.mocked(discoverSkills);
+
+function makeSkill(name: string, description: string, instructions: string): ParsedSkill {
+  return {
+    name,
+    description,
+    version: "1.0.0",
+    category: undefined,
+    platforms: [],
+    instructions,
+    raw: "",
+  };
+}
+
+let handlers: Map<string, (req: unknown) => Promise<unknown>>;
+
+beforeEach(async () => {
+  vi.clearAllMocks();
+
+  // Re-import to trigger module-level server creation
+  vi.resetModules();
+
+  // Re-mock after resetModules
+  vi.doMock("./discover.js", () => ({
+    discoverSkills: mockDiscoverSkills,
+  }));
+
+  vi.doMock("@modelcontextprotocol/sdk/server/index.js", () => {
+    const h = new Map<string, (req: unknown) => Promise<unknown>>();
+    handlers = h;
+    return {
+      Server: vi.fn().mockImplementation(() => ({
+        setRequestHandler: vi.fn((schema: { method: string }, handler: (req: unknown) => Promise<unknown>) => {
+          h.set(schema.method, handler);
+        }),
+        connect: vi.fn(),
+      })),
+    };
+  });
+
+  vi.doMock("@modelcontextprotocol/sdk/server/stdio.js", () => ({
+    StdioServerTransport: vi.fn(),
+  }));
+
+  vi.doMock("@modelcontextprotocol/sdk/types.js", () => ({
+    ListPromptsRequestSchema: { method: "prompts/list" },
+    GetPromptRequestSchema: { method: "prompts/get" },
+    ErrorCode: { InvalidRequest: -32600 },
+    McpError: class McpError extends Error {
+      code: number;
+      constructor(code: number, message: string) {
+        super(message);
+        this.code = code;
+      }
+    },
+  }));
+
+  // Suppress console.error from main()
+  vi.spyOn(console, "error").mockImplementation(() => {});
+
+  await import("./index.js");
+});
+
+describe("MCP server", () => {
+  it("registers prompts/list and prompts/get handlers", () => {
+    expect(handlers.has("prompts/list")).toBe(true);
+    expect(handlers.has("prompts/get")).toBe(true);
+  });
+
+  it("listPrompts returns discovered skills", async () => {
+    const skills = new Map<string, ParsedSkill>();
+    skills.set("code-review", makeSkill("Code Review", "Review code quality", "Review carefully"));
+    skills.set("security-scan", makeSkill("Security Scan", "Find vulnerabilities", "Check OWASP"));
+    mockDiscoverSkills.mockReturnValue(skills);
+
+    const handler = handlers.get("prompts/list")!;
+    const result = (await handler({})) as { prompts: Array<{ name: string; description: string }> };
+
+    expect(result.prompts).toHaveLength(2);
+    expect(result.prompts[0].name).toBe("code-review");
+    expect(result.prompts[0].description).toBe("Review code quality");
+    expect(result.prompts[1].name).toBe("security-scan");
+  });
+
+  it("listPrompts returns empty array when no skills installed", async () => {
+    mockDiscoverSkills.mockReturnValue(new Map());
+
+    const handler = handlers.get("prompts/list")!;
+    const result = (await handler({})) as { prompts: unknown[] };
+
+    expect(result.prompts).toEqual([]);
+  });
+
+  it("getPrompt returns skill instructions", async () => {
+    const skills = new Map<string, ParsedSkill>();
+    skills.set("code-review", makeSkill("Code Review", "Review code quality", "Review carefully"));
+    mockDiscoverSkills.mockReturnValue(skills);
+
+    const handler = handlers.get("prompts/get")!;
+    const result = (await handler({
+      params: { name: "code-review", arguments: {} },
+    })) as { description: string; messages: Array<{ role: string; content: { type: string; text: string } }> };
+
+    expect(result.description).toBe("Review code quality");
+    expect(result.messages).toHaveLength(1);
+    expect(result.messages[0].role).toBe("user");
+    expect(result.messages[0].content.text).toBe("Review carefully");
+  });
+
+  it("getPrompt appends input argument to instructions", async () => {
+    const skills = new Map<string, ParsedSkill>();
+    skills.set("code-review", makeSkill("Code Review", "Review code quality", "Review carefully"));
+    mockDiscoverSkills.mockReturnValue(skills);
+
+    const handler = handlers.get("prompts/get")!;
+    const result = (await handler({
+      params: { name: "code-review", arguments: { input: "Focus on error handling" } },
+    })) as { messages: Array<{ content: { text: string } }> };
+
+    expect(result.messages[0].content.text).toBe("Review carefully\n\nFocus on error handling");
+  });
+
+  it("getPrompt throws McpError for unknown skill", async () => {
+    mockDiscoverSkills.mockReturnValue(new Map());
+
+    const handler = handlers.get("prompts/get")!;
+
+    await expect(
+      handler({ params: { name: "nonexistent", arguments: {} } }),
+    ).rejects.toThrow('Unknown skill: nonexistent');
+  });
+});

package/src/index.ts

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  ListPromptsRequestSchema,
+  GetPromptRequestSchema,
+  ErrorCode,
+  McpError,
+} from "@modelcontextprotocol/sdk/types.js";
+import { discoverSkills } from "./discover.js";
+
+const server = new Server(
+  { name: "skills-hub", version: "0.1.0" },
+  { capabilities: { prompts: { listChanged: true } } },
+);
+
+server.setRequestHandler(ListPromptsRequestSchema, async () => {
+  const skills = discoverSkills();
+
+  return {
+    prompts: Array.from(skills.entries()).map(([slug, skill]) => ({
+      name: slug,
+      description: skill.description,
+      arguments: [
+        {
+          name: "input",
+          description: "Context or instructions for the skill",
+          required: false,
+        },
+      ],
+    })),
+  };
+});
+
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  const skills = discoverSkills();
+  const skill = skills.get(name);
+
+  if (!skill) {
+    throw new McpError(
+      ErrorCode.InvalidRequest,
+      `Unknown skill: ${name}. Run "skills-hub install ${name}" to install it.`,
+    );
+  }
+
+  let text = skill.instructions;
+  if (args?.input) {
+    text += `\n\n${args.input}`;
+  }
+
+  return {
+    description: skill.description,
+    messages: [
+      {
+        role: "user" as const,
+        content: { type: "text" as const, text },
+      },
+    ],
+  };
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  // stderr only — stdout is the MCP JSON-RPC stream
+  console.error("skills-hub MCP server running");
+}
+
+main().catch((err) => {
+  console.error("Fatal:", err);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}