@aistoragedepot/mcp 0.2.0 → 0.3.0

package/README.md

@@ -49,6 +49,26 @@ Your stored content shows up where you actually work:
 | `AISD_BASE_URL` | no | `https://www.aistoragedepot.com` | Point at a self-hosted / dev instance if needed. |
 | `AISD_WORKSPACES` | no | your personal library | Which workspaces expose **prompts** (slash-commands). Comma-separated workspace names (e.g. `My Library,Engineering`), or `all`. Keeps the slash menu short; **search and resources still cover every workspace** regardless. |
 
+## Slash-commands (`pull`)
+
+Not every client turns MCP prompts into `/` slash-commands (some only use the tools). To get
+your prompts as **native** slash-commands that always work, sync them to command files:
+
+```bash
+npx -y @aistoragedepot/mcp pull --token=aisd_your_token
+```
+
+This writes `~/.claude/commands/aistoragedepot/*.md` — start a new chat and type
+**`/aistoragedepot`** to see them. Re-run any time; it only clears and rewrites its own
+namespaced folder.
+
+| Option | Default | |
+| --- | --- | --- |
+| `--token=…` | `AISD_TOKEN` env | Your API token. |
+| `--workspaces="A,B"` | your personal library | Which workspaces to pull (names, or `all`). |
+| `--project` | off | Write to `./.claude/commands/…` (this repo) instead of your home dir. |
+| `--dir=<path>` | `~/.claude/commands/aistoragedepot` | Write somewhere else entirely. |
+
 ## Notes
 
 - Read-only in v0.1 (it surfaces and fetches your content; it doesn't write back).

package/index.mjs

@@ -22,6 +22,14 @@ import {
 } from "@modelcontextprotocol/sdk/types.js";
 
 const BASE_URL = (process.env.AISD_BASE_URL || "https://www.aistoragedepot.com").replace(/\/+$/, "");
+
+// CLI mode: `aistoragedepot-mcp pull` syncs prompts to native slash-command files, then exits.
+if (process.argv[2] === "pull") {
+  const { pull } = await import("./pull.mjs");
+  await pull({ BASE_URL, argv: process.argv.slice(3) });
+  process.exit(0);
+}
+
 const TOKEN = process.env.AISD_TOKEN;
 
 if (!TOKEN) {
@@ -123,7 +131,7 @@ function fillBody(body, placeholders, args) {
 }
 
 const server = new Server(
-  { name: "aistoragedepot", version: "0.2.0" },
+  { name: "aistoragedepot", version: "0.3.0" },
   { capabilities: { resources: {}, prompts: {}, tools: {} } },
 );
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aistoragedepot/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Model Context Protocol server for your AIStorageDepot library — exposes your prompts, rules, docs, and skills to MCP-aware AI clients (Claude, Cursor, Cline, …).",
   "type": "module",
   "bin": {
@@ -9,7 +9,8 @@
   "files": [
     "index.mjs",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "pull.mjs"
   ],
   "engines": {
     "node": ">=18"

package/pull.mjs

@@ -0,0 +1,90 @@
+// `aistoragedepot-mcp pull` — sync your library into native slash-command files.
+//
+// MCP prompts-as-slash-commands are supported inconsistently across clients, so this writes
+// real command files that any Claude Code client picks up: ~/.claude/commands/aistoragedepot/*.md
+// (a /aistoragedepot:<name> command each). Defaults to the **skills** in your personal library
+// (self-contained instructions that run cleanly as commands); widen with --workspaces / include
+// prompts with --types. Re-run any time — it clears and rewrites only its own namespaced folder.
+import { mkdir, writeFile, rm } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+
+const slug = (s) =>
+  String(s).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60) || "item";
+const typeOf = (it) => (it.type?.slug || it.type?.name || "").toLowerCase();
+
+function parseArgs(argv) {
+  const o = {};
+  for (const a of argv) {
+    const m = a.match(/^--([^=]+)(?:=(.*))?$/);
+    if (m) o[m[1]] = m[2] ?? true;
+  }
+  return o;
+}
+
+export async function pull({ BASE_URL, argv }) {
+  const o = parseArgs(argv);
+  const token = o.token || process.env.AISD_TOKEN;
+  if (!token) {
+    console.error(
+      "A token is required. Pass --token=aisd_… (create one in AIStorageDepot → Settings → API tokens), or set AISD_TOKEN.",
+    );
+    process.exit(1);
+  }
+  const api = async (p) => {
+    const r = await fetch(BASE_URL + p, { headers: { Authorization: `Bearer ${token}`, Accept: "application/json" } });
+    if (r.status === 401) throw new Error("Token rejected (401) — check it in Settings → API tokens.");
+    if (!r.ok) throw new Error(`${p} → HTTP ${r.status}`);
+    return r.json();
+  };
+
+  // Which item types to pull. Default: skills only. --types=skill,prompt | all.
+  const TYPES = String(o.types || "skill").toLowerCase().split(",").map((s) => s.trim()).filter(Boolean);
+  const wantType = (it) => {
+    const t = typeOf(it);
+    const isSkill = t === "skill";
+    const isPrompt = it.type?.format === "prompt" || t === "prompt";
+    if (TYPES.includes("all")) return isSkill || isPrompt;
+    return (TYPES.includes("skill") && isSkill) || (TYPES.includes("prompt") && isPrompt) || TYPES.includes(t);
+  };
+
+  const workspaces = await api("/api/workspaces");
+  // Scope: default every workspace; --workspaces="A,B" | "personal" | "all".
+  const names = String(o.workspaces || "").split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+  let scope;
+  if (names.includes("all") || names.includes("*")) scope = workspaces;
+  else if (names.length) scope = workspaces.filter((w) => names.includes((w.name || "").toLowerCase()));
+  else scope = workspaces.filter((w) => w.type === "PERSONAL"); // default: just your personal library
+
+  const libs = await Promise.all(
+    scope.map((w) => api(`/api/library?workspace=${encodeURIComponent(w.id)}`).catch(() => ({ items: [] }))),
+  );
+  const items = libs.flatMap((l) => (l.items || []).filter(wantType));
+
+  const dir = o.dir
+    ? resolve(String(o.dir))
+    : o.project
+      ? resolve(".claude", "commands", "aistoragedepot")
+      : join(homedir(), ".claude", "commands", "aistoragedepot");
+  await rm(dir, { recursive: true, force: true }); // clean re-sync of our namespaced folder only
+  await mkdir(dir, { recursive: true });
+
+  const used = new Set();
+  let n = 0;
+  for (const it of items) {
+    let name = slug(it.title);
+    while (used.has(name)) name = `${name}-${it.id.slice(-4)}`;
+    used.add(name);
+    const body = it.body || "";
+    // Skills already carry their own YAML frontmatter (name/description) — keep it as-is; for anything
+    // without frontmatter (e.g. prompts), add a description so it shows nicely in the / menu.
+    const content = /^---\r?\n/.test(body)
+      ? body.endsWith("\n") ? body : `${body}\n`
+      : `---\ndescription: "${`${it.title} (AIStorageDepot)`.replace(/"/g, "'").replace(/\s+/g, " ").trim()}"\n---\n\n${body}\n`;
+    await writeFile(join(dir, `${name}.md`), content, "utf8");
+    n++;
+  }
+
+  console.log(`✓ Synced ${n} item${n === 1 ? "" : "s"} (${TYPES.join(", ")}) → ${dir}`);
+  console.log(`  Start a new chat and type /aistoragedepot to use them.`);
+}