curatedmcp 2.0.0

package/dist/stack.js

@@ -0,0 +1,93 @@
+/**
+ * Stack — read/write the user's local MCP server registry at ~/.curatedmcp/stack.json
+ *
+ * This is the source of truth for which MCP servers Launcher proxies. It's intentionally
+ * file-based (no cloud sync, no auth) so users own their config and can hand-edit if they want.
+ *
+ * Schema is versioned so we can migrate forward without breaking older installs.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync, } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+const CONFIG_DIR = join(homedir(), ".curatedmcp");
+const STACK_FILE = join(CONFIG_DIR, "stack.json");
+const EMPTY_STACK = { version: 1, entries: [] };
+/** Returns the path to stack.json (so callers can show it to users). */
+export function stackPath() {
+    return STACK_FILE;
+}
+/**
+ * Read the stack from disk.
+ * Returns an empty stack if the file is missing, unreadable, or malformed —
+ * so a corrupt config never crashes the launcher.
+ */
+export function readStack() {
+    if (!existsSync(STACK_FILE))
+        return { ...EMPTY_STACK, entries: [] };
+    try {
+        const raw = readFileSync(STACK_FILE, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || parsed.version !== 1 || !Array.isArray(parsed.entries)) {
+            console.error(`[stack] ${STACK_FILE} has unexpected shape; treating as empty.`);
+            return { ...EMPTY_STACK, entries: [] };
+        }
+        return { version: 1, entries: parsed.entries.filter(isValidEntry) };
+    }
+    catch (err) {
+        console.error(`[stack] Failed to read ${STACK_FILE}:`, err);
+        return { ...EMPTY_STACK, entries: [] };
+    }
+}
+/**
+ * Atomically write the stack to disk.
+ * Writes to a temp sibling file, then renames — avoids a half-written file
+ * if the process is killed mid-write.
+ */
+export function writeStack(stack) {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    const tmp = `${STACK_FILE}.tmp-${process.pid}`;
+    writeFileSync(tmp, JSON.stringify(stack, null, 2) + "\n", "utf-8");
+    renameSync(tmp, STACK_FILE);
+}
+/**
+ * Add or replace an entry by slug. If an entry with the same slug exists,
+ * it's overwritten (so calling `add` twice updates env vars cleanly).
+ */
+export function upsertEntry(entry) {
+    const stack = readStack();
+    const idx = stack.entries.findIndex((e) => e.slug === entry.slug);
+    const stamped = {
+        ...entry,
+        addedAt: entry.addedAt ?? new Date().toISOString(),
+    };
+    if (idx >= 0) {
+        stack.entries[idx] = stamped;
+    }
+    else {
+        stack.entries.push(stamped);
+    }
+    writeStack(stack);
+    return stack;
+}
+/** Remove an entry by slug. No-op (returns false) if it wasn't there. */
+export function removeEntry(slug) {
+    const stack = readStack();
+    const before = stack.entries.length;
+    stack.entries = stack.entries.filter((e) => e.slug !== slug);
+    if (stack.entries.length === before)
+        return false;
+    writeStack(stack);
+    return true;
+}
+function isValidEntry(e) {
+    if (!e || typeof e !== "object")
+        return false;
+    const x = e;
+    return (typeof x.slug === "string" &&
+        typeof x.command === "string" &&
+        Array.isArray(x.args) &&
+        x.args.every((a) => typeof a === "string"));
+}
+//# sourceMappingURL=stack.js.map

package/dist/telemetry.d.ts

@@ -0,0 +1,15 @@
+interface Event {
+    event: "search" | "install" | "details" | "list-categories";
+    slug: string | null;
+    client: string | null;
+    query: string | null;
+}
+export declare class Telemetry {
+    private anonId;
+    private enabled;
+    constructor();
+    private loadOrCreateAnonId;
+    logEvent(event: Event): Promise<void>;
+}
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAcA,UAAU,KAAK;IACb,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,iBAAiB,CAAC;IAC5D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAU;;IAUzB,OAAO,CAAC,kBAAkB;IA6BpB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;CA4B5C"}

package/dist/telemetry.js

@@ -0,0 +1,71 @@
+import { randomUUID } from "crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+const API_URL = process.env.CURATOR_API_URL || "https://www.curatedmcp.com";
+const CONFIG_DIR = join(homedir(), ".curatedmcp");
+const CONFIG_FILE = join(CONFIG_DIR, "launcher.json");
+export class Telemetry {
+    constructor() {
+        this.enabled =
+            process.env.CURATOR_TELEMETRY !== "false" &&
+                process.argv[process.argv.length - 1] !== "--no-telemetry";
+        this.anonId = this.loadOrCreateAnonId();
+    }
+    loadOrCreateAnonId() {
+        try {
+            // Try to read existing config
+            const data = readFileSync(CONFIG_FILE, "utf-8");
+            const config = JSON.parse(data);
+            return config.anonId;
+        }
+        catch {
+            // Create new config with fresh UUID
+            const anonId = randomUUID();
+            try {
+                const config = {
+                    anonId,
+                    version: "1.0.1",
+                };
+                if (!existsSync(CONFIG_DIR)) {
+                    mkdirSync(CONFIG_DIR, { recursive: true });
+                }
+                writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+            }
+            catch (err) {
+                // Silently fail if we can't write config
+                console.error("[telemetry] Failed to write config (non-blocking):", err);
+            }
+            return anonId;
+        }
+    }
+    async logEvent(event) {
+        if (!this.enabled)
+            return;
+        try {
+            const payload = {
+                event: event.event,
+                anonId: this.anonId,
+                slug: event.slug,
+                client: event.client,
+                query: event.query,
+                ts: new Date().toISOString(),
+            };
+            await fetch(`${API_URL}/api/launcher/telemetry`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "User-Agent": "@curatedmcp/launcher/1.0.1",
+                },
+                body: JSON.stringify(payload),
+            }).catch(() => {
+                // Silently fail on network error
+            });
+        }
+        catch (err) {
+            // Non-blocking telemetry failures
+            // console.error("[telemetry] error:", err);
+        }
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/tools/get-details.d.ts

@@ -0,0 +1,14 @@
+export interface ServerDetails {
+    slug: string;
+    name: string;
+    tagline: string;
+    description: string;
+    category: string;
+    pricingType: string;
+    rating: number | null;
+    downloadCount: number;
+    repo?: string;
+    docsUrl?: string;
+}
+export declare function getServerDetails(slug: string): Promise<ServerDetails>;
+//# sourceMappingURL=get-details.d.ts.map

package/dist/tools/get-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-details.d.ts","sourceRoot":"","sources":["../../src/tools/get-details.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA0B3E"}

package/dist/tools/get-details.js

@@ -0,0 +1,27 @@
+const API_URL = process.env.CURATOR_API_URL || "https://www.curatedmcp.com";
+export async function getServerDetails(slug) {
+    const url = `${API_URL}/api/servers/${slug}`;
+    const res = await fetch(url, {
+        headers: { "User-Agent": "@curatedmcp/launcher/1.0.0" },
+    });
+    if (!res.ok) {
+        if (res.status === 404) {
+            throw new Error(`Server "${slug}" not found`);
+        }
+        throw new Error(`Failed to fetch details: ${res.status} ${res.statusText}`);
+    }
+    const data = (await res.json());
+    return {
+        slug: data.slug,
+        name: data.name,
+        tagline: data.tagline,
+        description: data.description,
+        category: data.category,
+        pricingType: data.pricingType,
+        rating: data.rating,
+        downloadCount: data.downloadCount,
+        repo: data.repository,
+        docsUrl: data.documentationUrl,
+    };
+}
+//# sourceMappingURL=get-details.js.map

package/dist/tools/install.d.ts

@@ -0,0 +1,2 @@
+export declare function installServer(slug: string, client?: "claude" | "cursor" | "windsurf"): Promise<string>;
+//# sourceMappingURL=install.d.ts.map

package/dist/tools/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/tools/install.ts"],"names":[],"mappings":"AAgBA,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,QAAQ,GAAG,QAAQ,GAAG,UAAqB,GAClD,OAAO,CAAC,MAAM,CAAC,CAgFjB"}

package/dist/tools/install.js

@@ -0,0 +1,74 @@
+const API_URL = process.env.CURATOR_API_URL || "https://www.curatedmcp.com";
+const CLIENT_PATHS = {
+    claude: "~/Library/Application Support/Claude/claude_desktop_config.json",
+    cursor: "~/.cursor/mcp.json",
+    windsurf: "~/.codeium/windsurf/mcp_config.json",
+};
+export async function installServer(slug, client = "claude") {
+    // Fetch server metadata
+    const url = `${API_URL}/api/servers/${slug}`;
+    const res = await fetch(url, {
+        headers: { "User-Agent": "@curatedmcp/launcher/1.0.0" },
+    });
+    if (!res.ok) {
+        if (res.status === 404) {
+            throw new Error(`Server "${slug}" not found`);
+        }
+        throw new Error(`Failed to fetch server: ${res.status}`);
+    }
+    const server = (await res.json());
+    const configPath = CLIENT_PATHS[client];
+    // Build config snippet based on server command type
+    const configEntry = {};
+    if (server.command === "npx") {
+        configEntry.command = "npx";
+        configEntry.args = ["-y", server.args?.[0] || slug];
+    }
+    else if (server.command === "uvx") {
+        configEntry.command = "uvx";
+        configEntry.args = server.args || [];
+    }
+    else if (server.command === "node") {
+        configEntry.command = "node";
+        configEntry.args = server.args || [];
+    }
+    else {
+        configEntry.command = server.command;
+        configEntry.args = server.args || [];
+    }
+    // Add environment variables if present
+    if (server.environmentVariables && server.environmentVariables.length > 0) {
+        configEntry.env = server.environmentVariables.reduce((acc, v) => {
+            acc[v.key] = `<your-${v.key.toLowerCase()}>`;
+            return acc;
+        }, {});
+    }
+    const configJson = JSON.stringify({
+        mcpServers: {
+            [slug]: configEntry,
+        },
+    }, null, 2);
+    // Prepare markdown response
+    const markdown = `# Install ${server.name}
+
+Add this to your \`${client}\` MCP config file:
+
+\`\`\`json
+${configJson}
+\`\`\`
+
+**Config path for ${client.toUpperCase()}:**
+\`\`\`
+${configPath}
+\`\`\`
+
+${server.environmentVariables && server.environmentVariables.length > 0
+        ? `**Environment variables needed:**\n\n${server.environmentVariables.map((v) => `- \`${v.key}\`: ${v.description || "See docs"}`).join("\n")}\n\n`
+        : ""}
+
+**Learn more:** ${server.documentationUrl || `https://www.curatedmcp.com/marketplace/${slug}`}
+
+Once installed, restart your client and ${server.name} will be available to use with \`@\` prompts.`;
+    return markdown;
+}
+//# sourceMappingURL=install.js.map

package/dist/tools/list-categories.d.ts

@@ -0,0 +1,2 @@
+export declare function listCategories(): string[];
+//# sourceMappingURL=list-categories.d.ts.map

package/dist/tools/list-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-categories.d.ts","sourceRoot":"","sources":["../../src/tools/list-categories.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAWzC"}

package/dist/tools/list-categories.js

@@ -0,0 +1,13 @@
+export function listCategories() {
+    return [
+        "DEVELOPER_TOOLS",
+        "WEB_AUTOMATION",
+        "DATABASE",
+        "CLOUD_SERVICES",
+        "AI_AGENTS",
+        "PRODUCTIVITY",
+        "COMMUNICATION",
+        "ANALYTICS",
+    ];
+}
+//# sourceMappingURL=list-categories.js.map

package/dist/tools/search.d.ts

@@ -0,0 +1,16 @@
+interface SearchResult {
+    slug: string;
+    name: string;
+    tagline: string;
+    category: string;
+    pricing: string;
+    rating: number | null;
+    downloads: number;
+}
+export declare function searchServers({ query, category, limit, }: {
+    query: string;
+    category?: string;
+    limit?: number;
+}): Promise<SearchResult[]>;
+export {};
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAEA,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,aAAa,CAAC,EAClC,KAAK,EACL,QAAQ,EACR,KAAU,GACX,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgB1B"}

package/dist/tools/search.js

@@ -0,0 +1,17 @@
+const API_URL = process.env.CURATOR_API_URL || "https://www.curatedmcp.com";
+export async function searchServers({ query, category, limit = 10, }) {
+    const params = new URLSearchParams();
+    params.set("q", query);
+    if (category)
+        params.set("category", category);
+    params.set("limit", Math.min(limit, 50).toString());
+    const url = `${API_URL}/api/launcher/search?${params}`;
+    const res = await fetch(url, {
+        headers: { "User-Agent": "@curatedmcp/launcher/1.0.0" },
+    });
+    if (!res.ok) {
+        throw new Error(`Search failed: ${res.status} ${res.statusText}`);
+    }
+    return (await res.json());
+}
+//# sourceMappingURL=search.js.map

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "curatedmcp",
+  "version": "2.0.0",
+  "description": "The CuratedMCP agent — discover, run, audit, and govern every MCP server your AI tools (Claude, Cursor, Windsurf, Copilot, Gemini) use",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "curatedmcp": "./dist/index.js",
+    "launcher": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.json",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "!dist/__tests__/",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc && cp src/guard/default-policy.json dist/guard/default-policy.json",
+    "dev": "node --loader ts-node/esm src/index.ts",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-hub",
+    "mcp-server",
+    "mcp-client",
+    "mcp-gateway",
+    "mcp-proxy",
+    "mcp-orchestrator",
+    "launcher",
+    "install",
+    "model-context-protocol",
+    "claude",
+    "claude-desktop",
+    "cursor",
+    "windsurf",
+    "copilot",
+    "gemini",
+    "anthropic",
+    "ai-tools",
+    "ai-agent",
+    "agent-orchestration",
+    "discovery"
+  ],
+  "author": "CuratedMCP",
+  "homepage": "https://curatedmcp.com/launcher",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oneprofile-dev/mcp-launcher"
+  },
+  "bugs": {
+    "url": "https://github.com/oneprofile-dev/mcp-launcher/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "chalk": "^5.3.0",
+    "express": "^4.18.0",
+    "minimatch": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.0",
+    "@types/node": "^20",
+    "typescript": "^5",
+    "vitest": "^1.0.0"
+  }
+}