mcpick 0.0.17 → 0.0.19

package/dist/claude-cli-BeA-bmoW.js

@@ -0,0 +1,394 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+//#region src/utils/claude-cli.ts
+const execAsync = promisify(exec);
+/**
+* Check if Claude CLI is available
+*/
+async function check_claude_cli() {
+	try {
+		await execAsync("claude --version");
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* Escape a string for shell usage
+*/
+function shell_escape(str) {
+	return `'${str.replace(/'/g, "'\\''")}'`;
+}
+/**
+* Validate environment variable key
+* Must start with letter or underscore, contain only alphanumeric and underscores
+*/
+function is_valid_env_key(key) {
+	return /^[A-Za-z_][A-Za-z0-9_]*$/.test(key);
+}
+/**
+* Build the claude mcp add command for a server
+*/
+function build_add_command(server, scope) {
+	const parts = [
+		"claude",
+		"mcp",
+		"add"
+	];
+	parts.push(shell_escape(server.name));
+	const transport = server.type || "stdio";
+	if (transport !== "stdio") parts.push("--transport", transport);
+	parts.push("--scope", scope);
+	if (transport === "stdio") {
+		if (server.env) {
+			for (const [key, value] of Object.entries(server.env)) if (is_valid_env_key(key)) parts.push("-e", `${key}=${shell_escape(value)}`);
+		}
+		if ("command" in server && server.command) {
+			parts.push("--");
+			parts.push(shell_escape(server.command));
+			if (server.args && server.args.length > 0) parts.push(...server.args.map((arg) => shell_escape(arg)));
+		}
+	} else {
+		if ("url" in server && server.url) parts.push(shell_escape(server.url));
+		if ("headers" in server && server.headers) for (const [key, value] of Object.entries(server.headers)) parts.push("-H", shell_escape(`${key}: ${value}`));
+	}
+	return parts.join(" ");
+}
+/**
+* Add an MCP server using Claude CLI
+*/
+async function add_mcp_via_cli(server, scope) {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	const command = build_add_command(server, scope);
+	try {
+		await execAsync(command);
+		return { success: true };
+	} catch (error) {
+		return {
+			success: false,
+			error: `Failed to add server via CLI: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* Remove an MCP server using Claude CLI
+*/
+async function remove_mcp_via_cli(name) {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	try {
+		await execAsync(`claude mcp remove ${shell_escape(name)}`);
+		return { success: true };
+	} catch (error) {
+		return {
+			success: false,
+			error: `Failed to remove server via CLI: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* Install a plugin via Claude CLI
+*/
+async function install_plugin_via_cli(key, scope = "user") {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	try {
+		await execAsync(`claude plugin install ${shell_escape(key)} --scope ${scope}`);
+		return { success: true };
+	} catch (error) {
+		return {
+			success: false,
+			error: `Failed to install plugin: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* Uninstall a plugin via Claude CLI
+*/
+async function uninstall_plugin_via_cli(key, scope = "user") {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	try {
+		await execAsync(`claude plugin uninstall ${shell_escape(key)} --scope ${scope}`);
+		return { success: true };
+	} catch (error) {
+		return {
+			success: false,
+			error: `Failed to uninstall plugin: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* Update a plugin via Claude CLI
+*/
+async function update_plugin_via_cli(key, scope = "user") {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	try {
+		await execAsync(`claude plugin update ${shell_escape(key)} --scope ${scope}`);
+		return { success: true };
+	} catch (error) {
+		return {
+			success: false,
+			error: `Failed to update plugin: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* Add a marketplace via Claude CLI
+*/
+/**
+* Extract GitHub owner/repo from various source formats.
+* Returns null if not a recognizable GitHub reference.
+*/
+function parse_github_repo(source) {
+	const https_match = source.match(/^https?:\/\/github\.com\/([^/]+)\/([^/.]+)(?:\.git)?$/);
+	if (https_match) return {
+		owner: https_match[1],
+		repo: https_match[2]
+	};
+	const ssh_match = source.match(/^git@github\.com:([^/]+)\/([^/.]+)(?:\.git)?$/);
+	if (ssh_match) return {
+		owner: ssh_match[1],
+		repo: ssh_match[2]
+	};
+	const shorthand_match = source.match(/^([^/\s]+)\/([^/\s]+)$/);
+	if (shorthand_match) return {
+		owner: shorthand_match[1],
+		repo: shorthand_match[2]
+	};
+	return null;
+}
+/**
+* Validate that a GitHub repository exists and is accessible.
+* Returns an error message if validation fails, null if OK.
+*/
+async function validate_github_repo(owner, repo) {
+	try {
+		const response = await fetch(`https://api.github.com/repos/${owner}/${repo}`, {
+			method: "GET",
+			headers: { Accept: "application/vnd.github.v3+json" }
+		});
+		if (response.status === 200) return null;
+		if (response.status === 404) return `Repository '${owner}/${repo}' not found on GitHub. Check the name or ensure it's not private.`;
+		if (response.status === 403) return `Access denied for '${owner}/${repo}'. The repository may be private — configure a GitHub token or use SSH.`;
+		return `GitHub API returned status ${response.status} for '${owner}/${repo}'.`;
+	} catch {
+		return null;
+	}
+}
+async function marketplace_add_via_cli(source) {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	const gh = parse_github_repo(source);
+	const is_shorthand = gh && !source.startsWith("http") && !source.startsWith("git@");
+	if (gh && is_shorthand) {
+		const validation_error = await validate_github_repo(gh.owner, gh.repo);
+		if (validation_error) return {
+			success: false,
+			error: validation_error
+		};
+	}
+	try {
+		await execAsync(`claude plugin marketplace add ${shell_escape(source)}`);
+		return { success: true };
+	} catch (error) {
+		const message = error instanceof Error ? error.message : "Unknown error";
+		if (message.includes("SSH") || message.includes("Permission denied (publickey)")) return {
+			success: false,
+			error: `SSH authentication failed for '${source}'. Either:\n  - Configure SSH keys: https://docs.github.com/en/authentication/connecting-to-github-with-ssh\n  - Use HTTPS URL instead: https://github.com/${gh ? `${gh.owner}/${gh.repo}` : source}`
+		};
+		if (message.includes("not found") || message.includes("does not exist")) return {
+			success: false,
+			error: `Repository '${source}' not found. Check the name and your access permissions.`
+		};
+		return {
+			success: false,
+			error: `Failed to add marketplace: ${message}`
+		};
+	}
+}
+/**
+* Remove a marketplace via Claude CLI
+*/
+async function marketplace_remove_via_cli(name) {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	try {
+		await execAsync(`claude plugin marketplace remove ${shell_escape(name)}`);
+		return { success: true };
+	} catch (error) {
+		return {
+			success: false,
+			error: `Failed to remove marketplace: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* Update marketplace(s) via Claude CLI
+*/
+async function marketplace_update_via_cli(name) {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	try {
+		await execAsync(name ? `claude plugin marketplace update ${shell_escape(name)}` : "claude plugin marketplace update");
+		return { success: true };
+	} catch (error) {
+		return {
+			success: false,
+			error: `Failed to update marketplace: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* List marketplaces via Claude CLI
+*/
+async function marketplace_list_via_cli() {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	try {
+		const { stdout } = await execAsync("claude plugin marketplace list");
+		return {
+			success: true,
+			stdout: stdout.trim()
+		};
+	} catch (error) {
+		return {
+			success: false,
+			error: `Failed to list marketplaces: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* Get the scope description for display
+*/
+function get_scope_description(scope) {
+	switch (scope) {
+		case "local": return "This project only (default)";
+		case "project": return "Shared via .mcp.json (version controlled)";
+		case "user": return "Global - all projects";
+	}
+}
+/**
+* Validate a plugin or marketplace manifest via Claude CLI
+*/
+async function validate_plugin_via_cli(path) {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	try {
+		const { stdout } = await execAsync(`claude plugin validate ${shell_escape(path)}`);
+		return {
+			success: true,
+			stdout: stdout.trim()
+		};
+	} catch (error) {
+		return {
+			success: false,
+			error: `Validation failed: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* Get details about an MCP server via Claude CLI
+*/
+async function mcp_get_via_cli(name) {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	try {
+		const { stdout } = await execAsync(`claude mcp get ${shell_escape(name)}`);
+		return {
+			success: true,
+			stdout: stdout.trim()
+		};
+	} catch (error) {
+		return {
+			success: false,
+			error: `Failed to get server details: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* Add an MCP server from raw JSON via Claude CLI
+*/
+async function mcp_add_json_via_cli(name, json, scope = "local") {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	try {
+		await execAsync(`claude mcp add-json ${shell_escape(name)} ${shell_escape(json)} --scope ${scope}`);
+		return { success: true };
+	} catch (error) {
+		return {
+			success: false,
+			error: `Failed to add server from JSON: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* Reset project-scoped MCP server choices via Claude CLI
+*/
+async function mcp_reset_project_choices_via_cli() {
+	if (!await check_claude_cli()) return {
+		success: false,
+		error: "Claude CLI not found. Please install Claude Code CLI."
+	};
+	try {
+		await execAsync("claude mcp reset-project-choices");
+		return { success: true };
+	} catch (error) {
+		return {
+			success: false,
+			error: `Failed to reset project choices: ${error instanceof Error ? error.message : "Unknown error"}`
+		};
+	}
+}
+/**
+* Get scope options for select prompt
+*/
+function get_scope_options() {
+	return [
+		{
+			value: "local",
+			label: "Local",
+			hint: "This project only (default)"
+		},
+		{
+			value: "project",
+			label: "Project",
+			hint: "Shared via .mcp.json (git)"
+		},
+		{
+			value: "user",
+			label: "User (Global)",
+			hint: "Available in all projects"
+		}
+	];
+}
+//#endregion
+export { install_plugin_via_cli as a, marketplace_remove_via_cli as c, mcp_get_via_cli as d, mcp_reset_project_choices_via_cli as f, validate_plugin_via_cli as g, update_plugin_via_cli as h, get_scope_options as i, marketplace_update_via_cli as l, uninstall_plugin_via_cli as m, check_claude_cli as n, marketplace_add_via_cli as o, remove_mcp_via_cli as p, get_scope_description as r, marketplace_list_via_cli as s, add_mcp_via_cli as t, mcp_add_json_via_cli as u };
+
+//# sourceMappingURL=claude-cli-BeA-bmoW.js.map

package/dist/cli-DNNZjJYL.js

@@ -0,0 +1,84 @@
+import { defineCommand, renderUsage, runMain } from "citty";
+//#region src/cli/index.ts
+const main = defineCommand({
+	meta: {
+		name: "mcpick",
+		description: "Claude Code extension manager — MCP servers, plugins (skills, hooks, agents), and marketplaces"
+	},
+	subCommands: {
+		list: () => import("./list-B8YeDWt6.js").then((m) => m.default),
+		enable: () => import("./enable-Bdnnn_Cq.js").then((m) => m.default),
+		disable: () => import("./disable-BA8tXPJN.js").then((m) => m.default),
+		remove: () => import("./remove-DIPWYMpk.js").then((m) => m.default),
+		add: () => import("./add-B9nVyh8T.js").then((m) => m.default),
+		"add-json": () => import("./add-json-CXNDl3al.js").then((m) => m.default),
+		clone: () => import("./clone-DLFLewBY.js").then((m) => m.default),
+		get: () => import("./get-BPjMXTMc.js").then((m) => m.default),
+		"reset-project-choices": () => import("./reset-project-choices-DRM5KByw.js").then((m) => m.default),
+		backup: () => import("./backup-DSDhHI5f.js").then((m) => m.default),
+		restore: () => import("./restore-DdMfUljI.js").then((m) => m.default),
+		profile: () => import("./profile-CX97sMGp.js").then((m) => m.default),
+		plugins: () => import("./plugins-DHYJF5CP.js").then((m) => m.default),
+		hooks: () => import("./hooks-Bmn7pUZa.js").then((m) => m.default),
+		cache: () => import("./cache-D6kd7qE8.js").then((m) => m.default),
+		dev: () => import("./dev-DRJRNp7y.js").then((m) => m.default),
+		marketplace: () => import("./marketplace-Br89Tg-Z.js").then((m) => m.default),
+		reload: () => import("./reload-CYDhkCVZ.js").then((m) => m.default)
+	}
+});
+/**
+* Custom help renderer that appends workflow guidance and examples
+* after citty's standard help output. This is critical for LLM agents
+* that rely on --help output to understand multi-step workflows.
+*/
+async function show_usage_with_examples(cmd, parent) {
+	const base = await renderUsage(cmd, parent);
+	if ((await (typeof cmd.meta === "function" ? cmd.meta() : cmd.meta))?.name === "mcpick") console.log(base + "\n" + WORKFLOW_SECTION + "\n" + CONCEPTS_SECTION + "\n" + EXAMPLES_SECTION + "\n");
+	else console.log(base + "\n");
+}
+const WORKFLOW_SECTION = `
+\x1b[4m\x1b[1mWORKFLOW\x1b[22m\x1b[24m Marketplaces contain plugins. Plugins contain skills (/slash-commands), hooks, agents, and MCP servers.
+
+  To install skills from a marketplace, follow these steps:
+
+  1. Add a marketplace:    mcpick marketplace add <source>
+  2. Install a plugin:     mcpick plugins install <name>@<marketplace>
+  3. Skills are now available as /slash-commands in Claude Code`;
+const CONCEPTS_SECTION = `
+\x1b[4m\x1b[1mCONCEPTS\x1b[22m\x1b[24m
+
+  Marketplace   A catalog of plugins, hosted on GitHub, GitLab, or locally
+  Plugin        A bundle containing any mix of: skills, hooks, agents, MCP servers
+  Skill         A SKILL.md file that extends Claude's behaviour, invocable as /slash-command
+  MCP server    A tool server providing external capabilities to Claude Code
+  Hook          An event handler that runs on tool use, session start, etc.
+  Profile       A saved snapshot of your MCP server and plugin configuration`;
+const EXAMPLES_SECTION = `
+\x1b[4m\x1b[1mEXAMPLES\x1b[22m\x1b[24m
+
+  Add a marketplace from GitHub (owner/repo):
+    mcpick marketplace add spences10/claude-code-toolkit
+
+  Add a marketplace from a full URL:
+    mcpick marketplace add https://github.com/spences10/claude-code-toolkit
+
+  Install a plugin from a marketplace:
+    mcpick plugins install my-plugin@claude-code-toolkit
+
+  List all installed plugins and their status:
+    mcpick plugins list
+
+  Toggle an MCP server on or off:
+    mcpick enable my-server
+    mcpick disable my-server
+
+  List all MCP servers:
+    mcpick list
+
+  All commands support --json for machine-readable output.
+  Run without arguments to launch the interactive TUI (not suitable for LLM agents).`;
+const run = () => runMain(main, { showUsage: show_usage_with_examples });
+//#endregion
+export { run };
+
+//# sourceMappingURL=cli-DNNZjJYL.js.map

package/dist/clone-DLFLewBY.js

@@ -0,0 +1,88 @@
+import { n as validate_mcp_server } from "./validation-xMlbgGCF.js";
+import { t as add_server_to_registry } from "./registry-CfUKT7_C.js";
+import { t as add_mcp_via_cli } from "./claude-cli-BeA-bmoW.js";
+import { i as find_server_in_scope, r as detect_server_scope } from "./config-DijVdEFn.js";
+import { n as output, t as error } from "./output-BchYq0mR.js";
+import { t as redact_server } from "./redact-O35tjnRD.js";
+import { defineCommand } from "citty";
+//#region src/cli/commands/clone.ts
+var clone_default = defineCommand({
+	meta: {
+		name: "clone",
+		description: "Clone an existing MCP server config with a new name, optionally overriding command/args"
+	},
+	args: {
+		source: {
+			type: "positional",
+			description: "Source server name to clone from",
+			required: true
+		},
+		name: {
+			type: "positional",
+			description: "New server name",
+			required: true
+		},
+		command: {
+			type: "string",
+			description: "Override command (e.g. \"node\" for local dev)"
+		},
+		args: {
+			type: "string",
+			description: "Override comma-separated arguments"
+		},
+		scope: {
+			type: "string",
+			description: "Scope for new server (default: same as source)"
+		},
+		json: {
+			type: "boolean",
+			description: "Output as JSON",
+			default: false
+		}
+	},
+	async run({ args }) {
+		if (args.scope && ![
+			"local",
+			"project",
+			"user"
+		].includes(args.scope)) error(`Invalid scope: ${args.scope}. Use local, project, or user.`);
+		const scope = args.scope;
+		let found;
+		if (scope) found = await find_server_in_scope(args.source, scope);
+		else found = await detect_server_scope(args.source);
+		if (!found) error(`Server '${args.source}' not found${scope ? ` in ${scope} scope` : " in any scope"}`);
+		const target_scope = args.scope || found.scope;
+		const cloned = {
+			...found.server,
+			name: args.name
+		};
+		if (args.command) {
+			cloned.command = args.command;
+			delete cloned.url;
+			if (cloned.type === "sse" || cloned.type === "http") delete cloned.type;
+		}
+		if (args.args) cloned.args = args.args.split(",");
+		let server;
+		try {
+			server = validate_mcp_server(cloned);
+		} catch (err) {
+			error(`Invalid cloned config: ${err instanceof Error ? err.message : "validation failed"}`);
+		}
+		await add_server_to_registry(server);
+		const result = await add_mcp_via_cli(server, target_scope);
+		if (args.json) output({
+			cloned: server.name,
+			from: args.source,
+			scope: target_scope,
+			server: redact_server(server),
+			cli: result.success,
+			error: result.error
+		}, true);
+		else if (result.success) console.log(`Cloned '${args.source}' → '${server.name}' (scope: ${target_scope})`);
+		else console.log(`Cloned '${args.source}' → '${server.name}' to registry but CLI failed: ${result.error}`);
+	}
+});
+//#endregion
+export { clone_default as default };
+
+//# sourceMappingURL=clone-DLFLewBY.js.map