mrmainspring 0.1.5 → 0.1.7

package/dist/cli.js

@@ -3,6 +3,7 @@ import { dirname, join } from "node:path";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { loadConfig } from "./config.js";
+import { setupAllClients, formatClientSetupReport } from "./client-setup.js";
 import { ensureGrimoireMasterKey, loadLocalEnvFile, resolveEnvPath } from "./env-file.js";
 import { getDefaultMainspringPaths } from "./paths.js";
 const _pkgRoot = dirname(dirname(fileURLToPath(import.meta.url)));
@@ -58,8 +59,15 @@ export function runCliCommand(args) {
     if (command === "setup") {
         const result = initializeLocalSetup();
         process.stdout.write(formatInitResult(result));
-        process.stdout.write(`\nPaste this into ${formatClientName(target)} MCP config:\n\n`);
-        process.stdout.write(`${formatMcpConfig()}\n`);
+        const clientResults = setupAllClients();
+        const report = formatClientSetupReport(clientResults);
+        if (report) {
+            process.stdout.write(report);
+        }
+        else {
+            process.stdout.write("\nNo MCP clients detected. Paste this into your client config manually:\n\n");
+            process.stdout.write(`${formatMcpConfig()}\n`);
+        }
         return true;
     }
     if (command === "doctor") {

package/dist/client-setup.d.ts

@@ -0,0 +1,8 @@
+export type ClientSetupResult = {
+    name: string;
+    configPath: string;
+    status: "written" | "already-set" | "not-installed" | "error";
+    error?: string;
+};
+export declare function setupAllClients(env?: NodeJS.ProcessEnv): ClientSetupResult[];
+export declare function formatClientSetupReport(results: ClientSetupResult[]): string;

package/dist/client-setup.js

@@ -0,0 +1,132 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { homedir } from "node:os";
+const MAINSPRING_ENTRY = {
+    command: "npx",
+    args: ["-y", "mrmainspring"]
+};
+const CLIENTS = [
+    // Claude Desktop
+    { name: "Claude Desktop", path: "~/Library/Application Support/Claude/claude_desktop_config.json", platforms: ["darwin"], format: "standard" },
+    { name: "Claude Desktop", path: "%APPDATA%/Claude/claude_desktop_config.json", platforms: ["win32"], format: "standard" },
+    { name: "Claude Desktop", path: "~/.config/Claude/claude_desktop_config.json", platforms: ["linux"], format: "standard" },
+    // Claude Code CLI
+    { name: "Claude Code", path: "~/.claude/settings.json", platforms: ["darwin", "linux", "win32"], format: "standard" },
+    // Cursor
+    { name: "Cursor", path: "~/.cursor/mcp.json", platforms: ["darwin", "linux"], format: "standard" },
+    { name: "Cursor", path: "%USERPROFILE%/.cursor/mcp.json", platforms: ["win32"], format: "standard" },
+    // Windsurf
+    { name: "Windsurf", path: "~/.codeium/windsurf/mcp_config.json", platforms: ["darwin", "linux", "win32"], format: "standard" },
+    // Windsurf (also on Windows via AppData)
+    { name: "Windsurf", path: "%APPDATA%/Windsurf/User/globalStorage/codeium.windsurf/mcp_config.json", platforms: ["win32"], format: "standard" },
+    // Zed
+    { name: "Zed", path: "~/.config/zed/settings.json", platforms: ["darwin", "linux"], format: "zed" },
+    // Continue.dev
+    { name: "Continue", path: "~/.continue/config.json", platforms: ["darwin", "linux", "win32"], format: "continue" },
+    // VS Code (workspace-agnostic user MCP config — requires MCP extension)
+    { name: "VS Code", path: "~/.vscode/mcp.json", platforms: ["darwin", "linux", "win32"], format: "standard" },
+];
+function expandPath(p, env) {
+    const home = env.HOME ?? env.USERPROFILE ?? homedir();
+    return p
+        .replace(/^~/, home)
+        .replace(/%APPDATA%/gi, env.APPDATA ?? "")
+        .replace(/%USERPROFILE%/gi, env.USERPROFILE ?? home);
+}
+function isInstalled(configPath) {
+    return existsSync(dirname(configPath)) || existsSync(configPath);
+}
+function readJson(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+function alreadySet(json, format) {
+    if (format === "zed") {
+        return !!json.context_servers?.mainspring;
+    }
+    if (format === "continue") {
+        const servers = json.mcpServers;
+        return !!servers?.some(s => s.name === "mainspring");
+    }
+    return !!json.mcpServers?.mainspring;
+}
+function mergeConfig(json, format) {
+    if (format === "zed") {
+        return {
+            ...json,
+            context_servers: {
+                ...(json.context_servers ?? {}),
+                mainspring: { command: { path: "npx", args: ["-y", "mrmainspring"] } }
+            }
+        };
+    }
+    if (format === "continue") {
+        const existing = (json.mcpServers ?? [])
+            .filter((s) => s.name !== "mainspring");
+        return {
+            ...json,
+            mcpServers: [...existing, { name: "mainspring", command: "npx", args: ["-y", "mrmainspring"] }]
+        };
+    }
+    return {
+        ...json,
+        mcpServers: {
+            ...(json.mcpServers ?? {}),
+            mainspring: MAINSPRING_ENTRY
+        }
+    };
+}
+export function setupAllClients(env = process.env) {
+    const plat = process.platform;
+    const results = [];
+    const seen = new Set();
+    for (const client of CLIENTS) {
+        if (!client.platforms.includes(plat))
+            continue;
+        const configPath = expandPath(client.path, env);
+        const key = `${client.name}:${configPath}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        if (!isInstalled(configPath)) {
+            results.push({ name: client.name, configPath, status: "not-installed" });
+            continue;
+        }
+        try {
+            const json = readJson(configPath);
+            if (alreadySet(json, client.format)) {
+                results.push({ name: client.name, configPath, status: "already-set" });
+                continue;
+            }
+            mkdirSync(dirname(configPath), { recursive: true });
+            writeFileSync(configPath, JSON.stringify(mergeConfig(json, client.format), null, 2) + "\n", "utf8");
+            results.push({ name: client.name, configPath, status: "written" });
+        }
+        catch (e) {
+            results.push({ name: client.name, configPath, status: "error", error: String(e) });
+        }
+    }
+    return results;
+}
+export function formatClientSetupReport(results) {
+    const active = results.filter(r => r.status !== "not-installed");
+    if (active.length === 0)
+        return "";
+    const lines = ["\nMCP clients configured:"];
+    for (const r of active) {
+        if (r.status === "written")
+            lines.push(`  [ok] ${r.name} → ${r.configPath}`);
+        else if (r.status === "already-set")
+            lines.push(`  [ok] ${r.name} → already configured`);
+        else
+            lines.push(`  [warn] ${r.name} → ${r.error}`);
+    }
+    lines.push("\nRestart any open MCP clients to load the server.");
+    return lines.join("\n") + "\n";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mrmainspring",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Mr Mainspring MCP backend with memory, Grimoire policies, audit, Casper anchoring, and x402 settlement boundaries.",
   "license": "MIT",
   "type": "module",