@aistoragedepot/mcp 0.1.0 → 0.3.0

package/README.md

@@ -16,6 +16,9 @@ Your stored content shows up where you actually work:
 
 ## Setup
 
+> **👉 Easiest path:** step-by-step instructions for each app (config-file locations and all)
+> are at **<https://www.aistoragedepot.com/connect>**. The manual version:
+
 1. In AIStorageDepot (a **PLUS** plan is required for API tokens), go to **Settings → API
    tokens** and create a token. Copy it.
 2. Add the server to your MCP client's config. Example (Claude Desktop /
@@ -44,6 +47,27 @@ Your stored content shows up where you actually work:
 | --- | --- | --- | --- |
 | `AISD_TOKEN` | yes | — | Token from Settings → API tokens. Has full access to your account — keep it secret. |
 | `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
 

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) {
@@ -43,15 +51,13 @@ let cache = { at: 0, workspaces: [], items: [] };
 async function snapshot() {
   if (cache.items.length && Date.now() - cache.at < 30_000) return cache;
   const workspaces = await api("/api/workspaces");
-  const items = [];
-  for (const ws of workspaces) {
-    try {
-      const lib = await api(`/api/library?workspace=${encodeURIComponent(ws.id)}`);
-      for (const it of lib.items || []) items.push(it);
-    } catch {
-      // a workspace we can't read (or that errored) — skip it, keep the rest.
-    }
-  }
+  // Fetch every workspace's library in parallel — the sequential loop was the slow part.
+  const libs = await Promise.all(
+    workspaces.map((ws) =>
+      api(`/api/library?workspace=${encodeURIComponent(ws.id)}`).catch(() => ({ items: [] })),
+    ),
+  );
+  const items = libs.flatMap((lib) => lib.items || []);
   cache = { at: Date.now(), workspaces, items };
   return cache;
 }
@@ -76,6 +82,31 @@ function promptIndex(items) {
   return byName;
 }
 
+// Which workspaces' prompts appear as slash-commands. Default: your personal library only —
+// keeps the slash menu short + fast (clients bury/limit long prompt lists). Override with
+// AISD_WORKSPACES="Name1,Name2" (comma-separated workspace names) or AISD_WORKSPACES="all".
+const PROMPT_WS = (process.env.AISD_WORKSPACES || "")
+  .split(",")
+  .map((s) => s.trim().toLowerCase())
+  .filter(Boolean);
+
+function promptScopeIds(workspaces) {
+  const all = () => new Set(workspaces.map((w) => w.id));
+  if (PROMPT_WS.includes("all") || PROMPT_WS.includes("*")) return all();
+  if (PROMPT_WS.length) {
+    const named = workspaces.filter((w) => PROMPT_WS.includes((w.name || "").toLowerCase()));
+    if (named.length) return new Set(named.map((w) => w.id));
+  }
+  const personal = workspaces.filter((w) => w.type === "PERSONAL");
+  return personal.length ? new Set(personal.map((w) => w.id)) : all();
+}
+
+// promptIndex, but only over items in the in-scope workspaces.
+function scopedPromptIndex(cache) {
+  const ids = promptScopeIds(cache.workspaces);
+  return promptIndex(cache.items.filter((it) => ids.has(it.workspaceId)));
+}
+
 // MCP argument names should be simple identifiers; map them back to the original
 // "[placeholder]" text so we can substitute into the body.
 function argMap(placeholders) {
@@ -100,7 +131,7 @@ function fillBody(body, placeholders, args) {
 }
 
 const server = new Server(
-  { name: "aistoragedepot", version: "0.1.0" },
+  { name: "aistoragedepot", version: "0.3.0" },
   { capabilities: { resources: {}, prompts: {}, tools: {} } },
 );
 
@@ -128,9 +159,8 @@ server.setRequestHandler(ReadResourceRequestSchema, async (req) => {
 
 // ---- Prompts: prompt-format items, [fields] → arguments ----
 server.setRequestHandler(ListPromptsRequestSchema, async () => {
-  const { items } = await snapshot();
   const prompts = [];
-  for (const [name, it] of promptIndex(items)) {
+  for (const [name, it] of scopedPromptIndex(await snapshot())) {
     const am = argMap(it.placeholders);
     prompts.push({
       name,
@@ -146,8 +176,7 @@ server.setRequestHandler(ListPromptsRequestSchema, async () => {
 });
 
 server.setRequestHandler(GetPromptRequestSchema, async (req) => {
-  const { items } = await snapshot();
-  const it = promptIndex(items).get(req.params.name);
+  const it = scopedPromptIndex(await snapshot()).get(req.params.name);
   if (!it) throw new Error(`Unknown prompt: ${req.params.name}`);
   const text = fillBody(it.body, it.placeholders, req.params.arguments || {});
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aistoragedepot/mcp",
-  "version": "0.1.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.`);
+}