@rishildi/ldi-process-skills 0.1.0

package/README.md

@@ -0,0 +1,133 @@
+# LDI Process Skills MCP Server
+
+Brings curated, step-by-step process skills to your AI agents through a local MCP server.
+
+Built by [Learn Data Insights](https://learndatainsights.com).
+
+## What it does
+
+This MCP server exposes a set of curated process skills as tools that your AI agent
+can call. The agent receives step-by-step instructions for data platform tasks —
+then executes them interactively with you.
+
+## Quick start
+
+### VS Code (with GitHub Copilot or Claude extension)
+
+Add to your MCP settings (`.vscode/mcp.json` or user settings):
+
+```json
+{
+  "servers": {
+    "ldi-process-skills": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@rishildi/ldi-process-skills"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ldi-process-skills": {
+      "command": "npx",
+      "args": ["-y", "@rishildi/ldi-process-skills"]
+    }
+  }
+}
+```
+
+### Verify
+
+Once connected, ask your AI agent:
+
+> "What skills are available?"
+
+It will call `list_skills` and show you the catalogue.
+
+## Prerequisites
+
+- **Node.js 18+** (for running the MCP server)
+- Additional prerequisites depend on the specific skills (e.g. Fabric CLI for Fabric skills)
+
+## Available tools
+
+| Tool | Description |
+|------|-------------|
+| `list_skills` | Lists all available skills with descriptions |
+| `<skill_name>` | Loads a specific skill's instructions (one tool per skill) |
+| `get_skill_file` | Fetch a specific template or reference from a skill |
+| `list_skill_files` | List all files available in a skill package |
+
+*(Tools are auto-generated from embedded skills. Each skill you add becomes a tool automatically.)*
+
+## How it works
+
+1. You ask your AI agent to perform a task
+2. The agent calls the appropriate skill tool on this MCP server
+3. The server returns detailed step-by-step instructions to the agent
+4. The agent follows the instructions, interacting with you along the way
+5. You see all the outputs — the skill instructions themselves stay inside the server
+
+## Licence
+
+This software is proprietary to Learn Data Insights Ltd.
+Unauthorised redistribution is not permitted.
+
+---
+
+## Development guide (maintainers only)
+
+### Adding a new skill
+
+1. Create a directory under `src/skills/<skill-name>/` with a `SKILL.md` and
+   optional `assets/` and `references/` subdirectories
+2. Run `npm run embed` to regenerate the embedded skills module
+3. Run `npm run build` to compile
+4. Test with `npm run inspect`
+
+### Build pipeline
+
+```
+src/skills/<skill-name>/   ──┐
+  SKILL.md                    │  embed-skills.ts
+  assets/                     ├──────────────────> src/skills/embedded.ts
+  references/                 │
+src/skills/<other-skill>/  ──┘
+                                                        │
+                                                        ▼ tsc
+                                                   build/index.js
+                                                        │
+                                                        ▼ npm publish
+                                              npm package (JS only)
+
+                                                   OR
+
+                                                        ▼ bun build --compile
+                                              dist/ldi-process-skills (binary)
+```
+
+### Scripts
+
+| Command | Description |
+|---------|-------------|
+| `npm run embed` | Regenerate embedded.ts from skill files |
+| `npm run build` | Embed + compile TypeScript |
+| `npm run build:compile` | Embed + compile to native binary (requires Bun) |
+| `npm run inspect` | Open MCP Inspector for testing |
+| `npm run start` | Run the server directly |
+
+### Testing with MCP Inspector
+
+```bash
+npm run build
+npm run inspect
+```
+
+This opens a web UI where you can call tools and verify responses.

package/build/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * LDI Process Skills MCP Server — Entry Point
+ *
+ * Starts the MCP server over stdio transport.
+ * This is the binary that learners run via npx.
+ *
+ * Usage:
+ *   npx @rishildi/ldi-process-skills
+ *   node build/index.js
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

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

package/build/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * LDI Process Skills MCP Server — Entry Point
+ *
+ * Starts the MCP server over stdio transport.
+ * This is the binary that learners run via npx.
+ *
+ * Usage:
+ *   npx @rishildi/ldi-process-skills
+ *   node build/index.js
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is reserved for MCP JSON-RPC messages)
+    console.error("LDI Process Skills MCP Server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/build/server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * LDI Process Skills MCP Server
+ *
+ * Exposes each embedded skill as:
+ * - A TOOL that returns the full SKILL.md instructions for the LLM to follow
+ * - A TOOL to fetch specific asset/reference files from a skill
+ * - A PROMPT for each skill as a quick-start entry point
+ * - A RESOURCE listing all available skills
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/build/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,YAAY,IAAI,SAAS,CA0NxC"}

package/build/server.js

@@ -0,0 +1,183 @@
+/**
+ * LDI Process Skills MCP Server
+ *
+ * Exposes each embedded skill as:
+ * - A TOOL that returns the full SKILL.md instructions for the LLM to follow
+ * - A TOOL to fetch specific asset/reference files from a skill
+ * - A PROMPT for each skill as a quick-start entry point
+ * - A RESOURCE listing all available skills
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { registry } from "./skills/registry.js";
+export function createServer() {
+    const server = new McpServer({
+        name: "ldi-process-skills",
+        version: "0.1.0",
+    });
+    // ──────────────────────────────────────────────────────────────────
+    // TOOL: list_skills
+    // Returns a catalogue of all available skills
+    // ──────────────────────────────────────────────────────────────────
+    server.registerTool("list_skills", {
+        title: "List available skills",
+        description: "Returns a list of all available LDI process skills with their names and descriptions. " +
+            "Call this first to discover what skills are available.",
+        inputSchema: {},
+        annotations: { readOnlyHint: true },
+    }, async () => {
+        const skills = registry.getAll();
+        const catalogue = skills.map((s) => ({
+            tool_name: s.name.replace(/-/g, "_"),
+            title: s.title,
+            description: s.description,
+        }));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(catalogue, null, 2),
+                },
+            ],
+        };
+    });
+    // ──────────────────────────────────────────────────────────────────
+    // TOOL: Per-skill tools (one per embedded skill)
+    // Each returns the full SKILL.md for the LLM to follow
+    // ──────────────────────────────────────────────────────────────────
+    for (const skill of registry.getAll()) {
+        const toolName = skill.name.replace(/-/g, "_");
+        server.registerTool(toolName, {
+            title: skill.title,
+            description: skill.description,
+            inputSchema: {
+                include_assets: z
+                    .boolean()
+                    .optional()
+                    .default(false)
+                    .describe("If true, also returns the contents of all asset and reference files."),
+            },
+            annotations: { readOnlyHint: true },
+        }, async ({ include_assets }) => {
+            const content = [
+                {
+                    type: "text",
+                    text: skill.skillMd,
+                },
+            ];
+            if (include_assets) {
+                // Include assets and references
+                const extras = skill.files.filter((f) => f.relativePath !== "SKILL.md" &&
+                    (f.relativePath.startsWith("assets/") ||
+                        f.relativePath.startsWith("references/")));
+                for (const file of extras) {
+                    content.push({
+                        type: "text",
+                        text: `\n--- FILE: ${file.relativePath} ---\n${file.content}`,
+                    });
+                }
+            }
+            return { content };
+        });
+    }
+    // ──────────────────────────────────────────────────────────────────
+    // TOOL: get_skill_file
+    // Fetches a specific file from a skill (asset, reference, template)
+    // ──────────────────────────────────────────────────────────────────
+    server.registerTool("get_skill_file", {
+        title: "Get a file from a skill package",
+        description: "Returns the content of a specific file from a skill package. " +
+            "Use this to fetch templates, reference docs, or asset files " +
+            "referenced in the SKILL.md instructions.",
+        inputSchema: {
+            skill_name: z
+                .string()
+                .describe('The skill tool name (e.g. "create_fabric_lakehouse")'),
+            file_path: z
+                .string()
+                .describe('Relative path within the skill (e.g. "assets/notebook-template.py")'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ skill_name, file_path }) => {
+        const content = registry.getFile(skill_name, file_path);
+        if (!content) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `File not found: ${file_path} in skill ${skill_name}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: content,
+                },
+            ],
+        };
+    });
+    // ──────────────────────────────────────────────────────────────────
+    // TOOL: list_skill_files
+    // Lists all files available in a given skill package
+    // ──────────────────────────────────────────────────────────────────
+    server.registerTool("list_skill_files", {
+        title: "List files in a skill package",
+        description: "Returns a list of all files (assets, references, templates) " +
+            "available in a specific skill package.",
+        inputSchema: {
+            skill_name: z
+                .string()
+                .describe('The skill tool name (e.g. "create_fabric_lakehouse")'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ skill_name }) => {
+        const skill = registry.get(skill_name);
+        if (!skill) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Skill not found: ${skill_name}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const fileList = skill.files.map((f) => f.relativePath);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(fileList, null, 2),
+                },
+            ],
+        };
+    });
+    // ──────────────────────────────────────────────────────────────────
+    // PROMPTS: One per skill as a quick-start entry point
+    // ──────────────────────────────────────────────────────────────────
+    for (const skill of registry.getAll()) {
+        const promptName = skill.name; // keep hyphens for prompt names
+        server.registerPrompt(promptName, {
+            title: skill.title,
+            description: `Quick-start prompt for the ${skill.title} skill`,
+        }, () => ({
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `I want to use the "${skill.title}" skill. ` +
+                            `Please call the ${skill.name.replace(/-/g, "_")} tool to load the skill instructions, ` +
+                            `then follow them step by step to help me.`,
+                    },
+                },
+            ],
+        }));
+    }
+    return server;
+}

package/build/skills/embedded.d.ts

@@ -0,0 +1,10 @@
+export interface SkillFile {
+    relativePath: string;
+    content: string;
+}
+export interface EmbeddedSkill {
+    name: string;
+    files: SkillFile[];
+}
+export declare const EMBEDDED_SKILLS: EmbeddedSkill[];
+//# sourceMappingURL=embedded.d.ts.map

package/build/skills/embedded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded.d.ts","sourceRoot":"","sources":["../../src/skills/embedded.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,eAAe,EAAE,aAAa,EAyN1C,CAAC"}