@mpurdon/mcp-servers 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthew Purdon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @mpurdon/mcp-servers
+
+The installer/configurator for the [@mpurdon MCP servers](https://github.com/mpurdon/mcp-servers).
+It registers any combination of the servers into **Claude Desktop**, **Claude Code**,
+or a **Claude Cowork** workspace — writing the right config file, idempotently.
+
+## Usage
+
+```bash
+# interactive: pick a host, pick servers, enter credentials, write config
+npx @mpurdon/mcp-servers configure
+
+# preview the exact changes without writing anything
+npx @mpurdon/mcp-servers configure --dry-run
+
+# list available servers
+npx @mpurdon/mcp-servers list
+```
+
+## Public and private servers
+
+The configurator offers two tiers in one selectable list:
+
+- **Public servers** — the npm-published `@mpurdon/mcp-*` packages, launched via `npx`.
+- **Private/local servers** — proprietary or work-specific servers whose code lives
+  in a separate private repo. They register themselves by dropping a descriptor in
+  `~/.mpurdon-mcp/servers.d/<key>.json` (each private repo provides its own
+  `*-register` command). The configurator auto-discovers these and launches them by
+  their local path. No proprietary detail ever lives in this public repo — only the
+  descriptor on your machine.
+
+So `configure` shows everything you have installed — public and private — as one list,
+marking private ones `(private)`.
+
+## What it does
+
+1. **Detects** your installed Claude host(s) and lets you choose one.
+2. Lets you **multi-select** which servers to enable (public + discovered private).
+3. **Prompts** for each server's required credentials (secrets are masked) — sourced
+   from the server registry, so the prompts always match what each server needs.
+4. **Merges** the entries into the host's `mcpServers` config without clobbering
+   anything else in the file. Re-running is safe (idempotent); existing entries
+   are only touched if they differ, and you're warned before any overwrite.
+5. Prints **follow-up steps** for servers that need extra setup (e.g. the FreshBooks
+   OAuth flow, or the MongoDB config file).
+
+## Config locations
+
+| Host                     | File                                                              |
+| ------------------------ | ----------------------------------------------------------------- |
+| Claude Desktop (macOS)   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json`                     |
+| Claude Desktop (Linux)   | `~/.config/Claude/claude_desktop_config.json`                     |
+| Claude Code              | `~/.claude.json`                                                  |
+| Claude Cowork            | `<workspace>/.mcp.json`                                           |
+
+After configuring, restart the host so it picks up the new servers.

package/dist/config-file.js

@@ -0,0 +1,59 @@
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from "node:fs";
+import { dirname } from "node:path";
+/** Read and parse an MCP config file, tolerating a missing or empty file. */
+export function readConfig(path) {
+    if (!existsSync(path))
+        return {};
+    const raw = readFileSync(path, "utf8").trim();
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch (err) {
+        throw new Error(`Existing config at ${path} is not valid JSON (${err.message}). ` +
+            "Fix or remove it before re-running.");
+    }
+}
+function entriesEqual(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+/** Compute what would change, without mutating anything. */
+export function planChanges(config, desired) {
+    const existing = config.mcpServers ?? {};
+    return Object.entries(desired).map(([key, entry]) => {
+        const prev = existing[key];
+        let action;
+        if (!prev)
+            action = "add";
+        else if (entriesEqual(prev, entry))
+            action = "unchanged";
+        else
+            action = "update";
+        return { key, action, entry };
+    });
+}
+/** Apply desired entries into the config object (in place) and return it. */
+export function applyChanges(config, desired) {
+    config.mcpServers = { ...(config.mcpServers ?? {}), ...desired };
+    return config;
+}
+/** Serialize and write the config, creating parent dirs as needed. */
+export function writeConfig(path, config) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(config, null, 2) + "\n", "utf8");
+}
+/** A human-readable diff of planned changes for --dry-run and confirmations. */
+export function renderPlan(path, changes) {
+    const lines = [`Target: ${path}`, ""];
+    for (const c of changes) {
+        const marker = c.action === "add" ? "+" : c.action === "update" ? "~" : "=";
+        lines.push(`  ${marker} ${c.key}  (${c.action})`);
+        const envKeys = Object.keys(c.entry.env ?? {});
+        const envDesc = envKeys.length > 0 ? `, env: ${envKeys.join(", ")}` : ", env: (none)";
+        lines.push(`      ${c.entry.command} ${c.entry.args.join(" ")}${envDesc}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=config-file.js.map

package/dist/config-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../src/config-file.ts"],"names":[],"mappings":"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"}

package/dist/configure.js

@@ -0,0 +1,114 @@
+import * as p from "@clack/prompts";
+import { HOSTS, getHost } from "./hosts.js";
+import { BUILTIN_SERVERS } from "./registry.js";
+import { allServers } from "./discovery.js";
+import { readConfig, planChanges, applyChanges, writeConfig, renderPlan, } from "./config-file.js";
+function bail(message = "Cancelled.") {
+    p.cancel(message);
+    process.exit(1);
+}
+function ensure(value) {
+    if (p.isCancel(value))
+        bail();
+    return value;
+}
+function entryFor(server, env) {
+    // Local/private servers carry an explicit launch command (e.g. a built dist
+    // on disk); public servers run from npm via npx.
+    const entry = server.launch
+        ? { command: server.launch.command, args: [...server.launch.args] }
+        : { command: "npx", args: ["-y", server.packageName] };
+    if (Object.keys(env).length > 0)
+        entry.env = env;
+    return entry;
+}
+export async function configure(opts) {
+    p.intro("@mpurdon/mcp-servers configure");
+    // 1. Pick a host (default to a detected one).
+    const detected = HOSTS.find((h) => h.id !== "cowork" && h.detect());
+    const hostId = ensure(await p.select({
+        message: "Which Claude host do you want to configure?",
+        initialValue: detected?.id ?? "desktop",
+        options: HOSTS.map((h) => ({
+            value: h.id,
+            label: h.title,
+            hint: h.id !== "cowork" && h.detect() ? "detected" : undefined,
+        })),
+    }));
+    const host = getHost(hostId);
+    // Resolve the target config path (Cowork needs a workspace dir).
+    let workspaceDir;
+    if (hostId === "cowork") {
+        workspaceDir = ensure(await p.text({
+            message: "Path to the Cowork workspace (its .mcp.json lives here):",
+            placeholder: process.cwd(),
+            defaultValue: process.cwd(),
+        }));
+    }
+    const targetPath = host.resolvePath({ workspaceDir });
+    if (!targetPath)
+        bail("Could not determine the config file path.");
+    // 2. Pick servers — built-in public servers plus any locally-registered
+    //    private servers discovered under ~/.mpurdon-mcp/servers.d/.
+    const servers = allServers(BUILTIN_SERVERS);
+    const chosen = ensure(await p.multiselect({
+        message: "Which servers do you want to enable?",
+        required: true,
+        options: servers.map((s) => ({
+            value: s.key,
+            label: s.source === "local" ? `${s.title} (private)` : s.title,
+            hint: s.description,
+        })),
+    }));
+    // 3. Collect env per server.
+    const desired = {};
+    const notes = [];
+    for (const key of chosen) {
+        const server = servers.find((s) => s.key === key);
+        const env = {};
+        for (const v of server.env) {
+            const value = v.secret
+                ? ensure(await p.password({
+                    message: `${server.title} — ${v.label}${v.required ? "" : " (optional)"}`,
+                    validate: (val) => (v.required && !val ? "Required." : undefined),
+                }))
+                : ensure(await p.text({
+                    message: `${server.title} — ${v.label}${v.required ? "" : " (optional)"}`,
+                    placeholder: v.default ?? "",
+                    defaultValue: v.default ?? "",
+                    validate: (val) => (v.required && !val ? "Required." : undefined),
+                }));
+            if (value)
+                env[v.key] = value;
+        }
+        desired[key] = entryFor(server, env);
+        if (server.configFile)
+            notes.push(`[${server.key}] ${server.configFile.note}`);
+        if (server.setupNote)
+            notes.push(`[${server.key}] ${server.setupNote}`);
+    }
+    // 4. Plan and show the diff.
+    const config = readConfig(targetPath);
+    const changes = planChanges(config, desired);
+    p.note(renderPlan(targetPath, changes), "Planned changes");
+    const overwrites = changes.filter((c) => c.action === "update");
+    if (overwrites.length > 0) {
+        p.log.warn(`This will overwrite existing entries: ${overwrites.map((c) => c.key).join(", ")}`);
+    }
+    if (opts.dryRun) {
+        p.outro("Dry run — no files were modified.");
+        return;
+    }
+    const proceed = ensure(await p.confirm({ message: `Write these changes to ${targetPath}?` }));
+    if (!proceed)
+        bail("No changes written.");
+    // 5. Apply.
+    applyChanges(config, desired);
+    writeConfig(targetPath, config);
+    p.log.success(`Updated ${targetPath}`);
+    if (notes.length > 0) {
+        p.note(notes.join("\n\n"), "Follow-up steps");
+    }
+    p.outro(`Done. Restart ${host.title} so it picks up the new server${chosen.length > 1 ? "s" : ""}.`);
+}
+//# sourceMappingURL=configure.js.map

package/dist/configure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../src/configure.ts"],"names":[],"mappings":"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"}

package/dist/discovery.js

@@ -0,0 +1,72 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Directory where private/local MCP servers drop a descriptor so the public
+ * configure CLI can offer them alongside the built-in public servers. Each
+ * file is `<key>.json` describing one server. This keeps proprietary details
+ * entirely on the user's machine — the public CLI ships no knowledge of them.
+ */
+export const SERVERS_DIR = join(homedir(), ".mpurdon-mcp", "servers.d");
+function isValidDescriptor(d) {
+    if (!d || typeof d !== "object")
+        return false;
+    const o = d;
+    return (typeof o.key === "string" &&
+        typeof o.title === "string" &&
+        typeof o.description === "string" &&
+        !!o.launch &&
+        typeof o.launch === "object" &&
+        typeof o.launch.command === "string" &&
+        Array.isArray(o.launch.args));
+}
+/**
+ * Read all locally-registered private server descriptors. Returns ServerDefs
+ * tagged `source: "local"`. Invalid/unreadable files are skipped with a warning
+ * to stderr rather than aborting the whole run.
+ */
+export function discoverLocalServers() {
+    if (!existsSync(SERVERS_DIR))
+        return [];
+    const out = [];
+    for (const file of readdirSync(SERVERS_DIR)) {
+        if (!file.endsWith(".json"))
+            continue;
+        const path = join(SERVERS_DIR, file);
+        try {
+            const parsed = JSON.parse(readFileSync(path, "utf8"));
+            if (!isValidDescriptor(parsed)) {
+                process.stderr.write(`[mcp-servers] skipping invalid descriptor: ${path}\n`);
+                continue;
+            }
+            out.push({
+                key: parsed.key,
+                title: parsed.title,
+                description: parsed.description,
+                launch: parsed.launch,
+                env: parsed.env ?? [],
+                configFile: parsed.configFile,
+                setupNote: parsed.setupNote,
+                source: "local",
+            });
+        }
+        catch (err) {
+            process.stderr.write(`[mcp-servers] could not read descriptor ${path}: ${err.message}\n`);
+        }
+    }
+    return out;
+}
+/**
+ * Merge built-in public servers with discovered local ones. Local descriptors
+ * win on key collision (lets you override a public server with a local build).
+ */
+export function allServers(builtin) {
+    const local = discoverLocalServers();
+    const byKey = new Map();
+    for (const s of builtin)
+        byKey.set(s.key, s);
+    for (const s of local)
+        byKey.set(s.key, s);
+    return [...byKey.values()];
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"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"}

package/dist/hosts.js

@@ -0,0 +1,46 @@
+import { existsSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+function desktopConfigPath() {
+    const home = homedir();
+    switch (platform()) {
+        case "darwin":
+            return join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+        case "win32":
+            return join(process.env.APPDATA ?? join(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json");
+        default:
+            // Linux / others
+            return join(home, ".config", "Claude", "claude_desktop_config.json");
+    }
+}
+export const HOSTS = [
+    {
+        id: "desktop",
+        title: "Claude Desktop",
+        resolvePath: () => desktopConfigPath(),
+        detect: () => {
+            const p = desktopConfigPath();
+            // The parent dir existing is a good signal even before any MCP is added.
+            return existsSync(p) || existsSync(join(p, ".."));
+        },
+    },
+    {
+        id: "code",
+        title: "Claude Code",
+        resolvePath: () => join(homedir(), ".claude.json"),
+        detect: () => existsSync(join(homedir(), ".claude.json")),
+    },
+    {
+        id: "cowork",
+        title: "Claude Cowork (workspace .mcp.json)",
+        resolvePath: ({ workspaceDir }) => workspaceDir ? join(workspaceDir, ".mcp.json") : null,
+        detect: () => true, // always selectable; path is prompted
+    },
+];
+export function getHost(id) {
+    const host = HOSTS.find((h) => h.id === id);
+    if (!host)
+        throw new Error(`Unknown host: ${id}`);
+    return host;
+}
+//# sourceMappingURL=hosts.js.map

package/dist/hosts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosts.js","sourceRoot":"","sources":["../src/hosts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAgBjC,SAAS,iBAAiB;IACxB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,QAAQ,QAAQ,EAAE,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,IAAI,CACT,IAAI,EACJ,SAAS,EACT,qBAAqB,EACrB,QAAQ,EACR,4BAA4B,CAC7B,CAAC;QACJ,KAAK,OAAO;YACV,OAAO,IAAI,CACT,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EACvD,QAAQ,EACR,4BAA4B,CAC7B,CAAC;QACJ;YACE,iBAAiB;YACjB,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAc;IAC9B;QACE,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE;QACtC,MAAM,EAAE,GAAG,EAAE;YACX,MAAM,CAAC,GAAG,iBAAiB,EAAE,CAAC;YAC9B,yEAAyE;YACzE,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;KACF;IACD;QACE,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC;QAClD,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;KAC1D;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,qCAAqC;QAC5C,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAChC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI;QACvD,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,sCAAsC;KAC3D;CACF,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { configure } from "./configure.js";
+import { BUILTIN_SERVERS } from "./registry.js";
+import { allServers } from "./discovery.js";
+const HELP = `@mpurdon/mcp-servers — install & configure @mpurdon MCP servers
+
+Usage:
+  npx @mpurdon/mcp-servers configure [--dry-run]
+  npx @mpurdon/mcp-servers list
+  npx @mpurdon/mcp-servers --help
+
+Commands:
+  configure    Interactively register servers into Claude Desktop, Code, or Cowork.
+  list         Print the available servers.
+
+Options:
+  --dry-run    Show the planned config changes without writing anything.
+  -h, --help   Show this help.
+`;
+function list() {
+    for (const s of allServers(BUILTIN_SERVERS)) {
+        const origin = s.source === "local" ? "(private, local)" : (s.packageName ?? "");
+        process.stdout.write(`${s.key.padEnd(12)} ${origin}\n`);
+        process.stdout.write(`${" ".repeat(12)} ${s.description}\n`);
+    }
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    if (argv.includes("-h") || argv.includes("--help") || argv.length === 0) {
+        process.stdout.write(HELP);
+        return;
+    }
+    const command = argv[0];
+    switch (command) {
+        case "configure":
+            await configure({ dryRun: argv.includes("--dry-run") });
+            break;
+        case "list":
+            list();
+            break;
+        default:
+            process.stderr.write(`Unknown command: ${command}\n\n${HELP}`);
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`[mcp-servers] fatal: ${err.stack ?? err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,IAAI,GAAG;;;;;;;;;;;;;;CAcZ,CAAC;AAEF,SAAS,IAAI;IACX,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5C,MAAM,MAAM,GACV,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC;QACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,WAAW;YACd,MAAM,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YACxD,MAAM;QACR,KAAK,MAAM;YACT,IAAI,EAAE,CAAC;YACP,MAAM;QACR;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,OAAO,IAAI,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAyB,GAAa,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC;IAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/registry.js

@@ -0,0 +1,90 @@
+/**
+ * The single source of truth for which @mpurdon MCP servers exist and how they
+ * are configured. The configurator drives every prompt from this list.
+ */
+export const SERVERS = [
+    {
+        key: "mongodb",
+        packageName: "@mpurdon/mcp-mongodb",
+        title: "MongoDB",
+        description: "Query/manage MongoDB across dev/stg/prd with production write-protection.",
+        env: [],
+        configFile: {
+            relativePath: ".mongodb-mcp/config.json",
+            note: "Create ~/.mongodb-mcp/config.json with your dev/stg/prd connection strings " +
+                "(chmod 600). See the @mpurdon/mcp-mongodb README for the exact shape.",
+        },
+    },
+    {
+        key: "freshbooks",
+        packageName: "@mpurdon/mcp-freshbooks",
+        title: "FreshBooks",
+        description: "FreshBooks invoices, clients, items, and time entries.",
+        env: [
+            {
+                key: "FRESHBOOKS_CLIENT_ID",
+                label: "FreshBooks app Client ID",
+                required: true,
+                secret: false,
+            },
+            {
+                key: "FRESHBOOKS_CLIENT_SECRET",
+                label: "FreshBooks app Client Secret",
+                required: true,
+                secret: true,
+            },
+        ],
+        setupNote: "After registering, run `npx -y @mpurdon/mcp-freshbooks freshbooks-setup` once " +
+            "to complete the OAuth flow and store tokens at ~/.freshbooks-mcp/tokens.json.",
+    },
+    {
+        key: "sumologic",
+        packageName: "@mpurdon/mcp-sumologic",
+        title: "Sumo Logic",
+        description: "Run Sumo Logic searches and inspect results.",
+        env: [
+            {
+                key: "SUMOLOGIC_ACCESS_ID",
+                label: "Sumo Logic Access ID",
+                required: true,
+                secret: false,
+            },
+            {
+                key: "SUMOLOGIC_ACCESS_KEY",
+                label: "Sumo Logic Access Key",
+                required: true,
+                secret: true,
+            },
+            {
+                key: "SUMOLOGIC_API_ENDPOINT",
+                label: "Sumo Logic API endpoint",
+                required: false,
+                secret: false,
+                default: "https://api.sumologic.com/api",
+            },
+        ],
+    },
+    {
+        key: "github",
+        packageName: "@mpurdon/mcp-github",
+        title: "GitHub",
+        description: "GitHub org/repo/PR/issue and Actions workflow operations.",
+        env: [
+            {
+                key: "GITHUB_TOKEN",
+                label: "GitHub personal access token",
+                required: true,
+                secret: true,
+            },
+        ],
+    },
+];
+/** Built-in (public, npm-published) servers, tagged with their source. */
+export const BUILTIN_SERVERS = SERVERS.map((s) => ({
+    ...s,
+    source: "builtin",
+}));
+export function findServer(key) {
+    return SERVERS.find((s) => s.key === key);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+CH,MAAM,CAAC,MAAM,OAAO,GAAgB;IAClC;QACE,GAAG,EAAE,SAAS;QACd,WAAW,EAAE,sBAAsB;QACnC,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,2EAA2E;QAC7E,GAAG,EAAE,EAAE;QACP,UAAU,EAAE;YACV,YAAY,EAAE,0BAA0B;YACxC,IAAI,EACF,6EAA6E;gBAC7E,uEAAuE;SAC1E;KACF;IACD;QACE,GAAG,EAAE,YAAY;QACjB,WAAW,EAAE,yBAAyB;QACtC,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,wDAAwD;QACrE,GAAG,EAAE;YACH;gBACE,GAAG,EAAE,sBAAsB;gBAC3B,KAAK,EAAE,0BAA0B;gBACjC,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,KAAK;aACd;YACD;gBACE,GAAG,EAAE,0BAA0B;gBAC/B,KAAK,EAAE,8BAA8B;gBACrC,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;aACb;SACF;QACD,SAAS,EACP,gFAAgF;YAChF,+EAA+E;KAClF;IACD;QACE,GAAG,EAAE,WAAW;QAChB,WAAW,EAAE,wBAAwB;QACrC,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,8CAA8C;QAC3D,GAAG,EAAE;YACH;gBACE,GAAG,EAAE,qBAAqB;gBAC1B,KAAK,EAAE,sBAAsB;gBAC7B,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,KAAK;aACd;YACD;gBACE,GAAG,EAAE,sBAAsB;gBAC3B,KAAK,EAAE,uBAAuB;gBAC9B,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;aACb;YACD;gBACE,GAAG,EAAE,wBAAwB;gBAC7B,KAAK,EAAE,yBAAyB;gBAChC,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,+BAA+B;aACzC;SACF;KACF;IACD;QACE,GAAG,EAAE,QAAQ;QACb,WAAW,EAAE,qBAAqB;QAClC,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,2DAA2D;QACxE,GAAG,EAAE;YACH;gBACE,GAAG,EAAE,cAAc;gBACnB,KAAK,EAAE,8BAA8B;gBACrC,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;aACb;SACF;KACF;CACF,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAgB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9D,GAAG,CAAC;IACJ,MAAM,EAAE,SAAS;CAClB,CAAC,CAAC,CAAC;AAEJ,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@mpurdon/mcp-servers",
+  "version": "0.1.0",
+  "description": "Installer/configurator for @mpurdon MCP servers across Claude Desktop, Cowork, and Code.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-servers": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "cli",
+    "installer"
+  ],
+  "license": "MIT",
+  "author": "Matthew Purdon",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mpurdon/mcp-servers.git",
+    "directory": "packages/cli"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.8.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "eslint": "^9.17.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "@mpurdon/eslint-config": "0.0.0",
+    "@mpurdon/tsconfig": "0.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  }
+}