mcpick 0.0.17 → 0.0.19

package/dist/utils/claude-cli.js

@@ -1,483 +0,0 @@
-import { exec } from 'node:child_process';
-import { promisify } from 'node:util';
-const execAsync = promisify(exec);
-/**
- * Check if Claude CLI is available
- */
-export 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) {
-    // Replace single quotes with escaped version
-    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'];
-    // Server name
-    parts.push(shell_escape(server.name));
-    // Transport type
-    const transport = server.type || 'stdio';
-    parts.push('--transport', transport);
-    // Scope
-    parts.push('--scope', scope);
-    // Handle different transport types
-    if (transport === 'stdio') {
-        // Environment variables (skip invalid keys to prevent injection)
-        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)}`);
-                }
-            }
-        }
-        // Command and args (after --)
-        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 {
-        // HTTP or SSE transport — URL must come before header flags
-        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
- */
-export async function add_mcp_via_cli(server, scope) {
-    // Check if CLI is available
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        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) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Failed to add server via CLI: ${message}`,
-        };
-    }
-}
-/**
- * Remove an MCP server using Claude CLI
- */
-export async function remove_mcp_via_cli(name) {
-    // Check if CLI is available
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        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) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Failed to remove server via CLI: ${message}`,
-        };
-    }
-}
-/**
- * Install a plugin via Claude CLI
- */
-export async function install_plugin_via_cli(key, scope = 'user') {
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        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) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Failed to install plugin: ${message}`,
-        };
-    }
-}
-/**
- * Uninstall a plugin via Claude CLI
- */
-export async function uninstall_plugin_via_cli(key, scope = 'user') {
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        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) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Failed to uninstall plugin: ${message}`,
-        };
-    }
-}
-/**
- * Update a plugin via Claude CLI
- */
-export async function update_plugin_via_cli(key, scope = 'user') {
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        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) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Failed to update plugin: ${message}`,
-        };
-    }
-}
-/**
- * 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) {
-    // HTTPS URL: https://github.com/owner/repo[.git]
-    const https_match = source.match(/^https?:\/\/github\.com\/([^/]+)\/([^/.]+)(?:\.git)?$/);
-    if (https_match)
-        return { owner: https_match[1], repo: https_match[2] };
-    // SSH URL: git@github.com:owner/repo[.git]
-    const ssh_match = source.match(/^git@github\.com:([^/]+)\/([^/.]+)(?:\.git)?$/);
-    if (ssh_match)
-        return { owner: ssh_match[1], repo: ssh_match[2] };
-    // Shorthand: owner/repo (no slashes beyond the one separator)
-    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 {
-        // Network error — skip validation and let the CLI attempt the clone
-        return null;
-    }
-}
-export async function marketplace_add_via_cli(source) {
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        return {
-            success: false,
-            error: 'Claude CLI not found. Please install Claude Code CLI.',
-        };
-    }
-    // Validate GitHub repo exists before attempting clone
-    // Only validate shorthand (owner/repo) — explicit URLs imply the user knows the repo
-    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';
-        // Provide clearer error messages for common failures
-        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
- */
-export async function marketplace_remove_via_cli(name) {
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        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) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Failed to remove marketplace: ${message}`,
-        };
-    }
-}
-/**
- * Update marketplace(s) via Claude CLI
- */
-export async function marketplace_update_via_cli(name) {
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        return {
-            success: false,
-            error: 'Claude CLI not found. Please install Claude Code CLI.',
-        };
-    }
-    try {
-        const cmd = name
-            ? `claude plugin marketplace update ${shell_escape(name)}`
-            : 'claude plugin marketplace update';
-        await execAsync(cmd);
-        return { success: true };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Failed to update marketplace: ${message}`,
-        };
-    }
-}
-/**
- * List marketplaces via Claude CLI
- */
-export async function marketplace_list_via_cli() {
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        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) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Failed to list marketplaces: ${message}`,
-        };
-    }
-}
-/**
- * Get the scope description for display
- */
-export 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
- */
-export async function validate_plugin_via_cli(path) {
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        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) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Validation failed: ${message}`,
-        };
-    }
-}
-/**
- * Get details about an MCP server via Claude CLI
- */
-export async function mcp_get_via_cli(name) {
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        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) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Failed to get server details: ${message}`,
-        };
-    }
-}
-/**
- * Add an MCP server from raw JSON via Claude CLI
- */
-export async function mcp_add_json_via_cli(name, json, scope = 'local') {
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        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) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Failed to add server from JSON: ${message}`,
-        };
-    }
-}
-/**
- * Reset project-scoped MCP server choices via Claude CLI
- */
-export async function mcp_reset_project_choices_via_cli() {
-    const cli_available = await check_claude_cli();
-    if (!cli_available) {
-        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) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            success: false,
-            error: `Failed to reset project choices: ${message}`,
-        };
-    }
-}
-/**
- * Get scope options for select prompt
- */
-export 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',
-        },
-    ];
-}
-//# sourceMappingURL=claude-cli.js.map

package/dist/utils/paths.js

@@ -1,114 +0,0 @@
-import { existsSync } from 'node:fs';
-import { access, mkdir } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-export function get_base_dir() {
-    const configDir = process.env.CLAUDE_CONFIG_DIR;
-    if (configDir && configDir.length > 0 && existsSync(configDir)) {
-        return {
-            baseDir: configDir,
-            parentDir: dirname(configDir),
-            coLocatedConfig: true,
-        };
-    }
-    const defaultDir = join(homedir(), '.claude');
-    return {
-        baseDir: defaultDir,
-        parentDir: dirname(defaultDir),
-        coLocatedConfig: false,
-    };
-}
-export function get_claude_config_path() {
-    const { baseDir, parentDir, coLocatedConfig } = get_base_dir();
-    if (coLocatedConfig) {
-        return join(baseDir, '.claude.json');
-    }
-    return join(parentDir, '.claude.json');
-}
-export function get_claude_settings_path() {
-    return join(get_base_dir().baseDir, 'settings.json');
-}
-export function get_mcpick_dir() {
-    return join(get_base_dir().baseDir, 'mcpick');
-}
-export function get_dev_overrides_path() {
-    return join(get_mcpick_dir(), 'dev-overrides.json');
-}
-export function get_server_registry_path() {
-    return join(get_mcpick_dir(), 'servers.json');
-}
-export function get_backups_dir() {
-    return join(get_mcpick_dir(), 'backups');
-}
-export function get_profiles_dir() {
-    return join(get_mcpick_dir(), 'profiles');
-}
-export function get_profile_path(name) {
-    // Allow .json extension or add it
-    const filename = name.endsWith('.json') ? name : `${name}.json`;
-    return join(get_profiles_dir(), filename);
-}
-function format_backup_timestamp() {
-    const now = new Date();
-    const year = now.getFullYear();
-    const month = String(now.getMonth() + 1).padStart(2, '0');
-    const day = String(now.getDate()).padStart(2, '0');
-    const hour = String(now.getHours()).padStart(2, '0');
-    const minute = String(now.getMinutes()).padStart(2, '0');
-    const second = String(now.getSeconds()).padStart(2, '0');
-    return `${year}-${month}-${day}-${hour}${minute}${second}`;
-}
-export function get_backup_filename() {
-    return `mcp-servers-${format_backup_timestamp()}.json`;
-}
-export function get_plugin_backup_filename() {
-    return `plugins-${format_backup_timestamp()}.json`;
-}
-export async function ensure_directory_exists(dir_path) {
-    try {
-        await access(dir_path);
-    }
-    catch {
-        await mkdir(dir_path, { recursive: true });
-    }
-}
-/**
- * Get the current working directory (project path)
- */
-export function get_current_project_path() {
-    return process.cwd();
-}
-/**
- * Get the path to .mcp.json in the current project directory (project scope)
- */
-export function get_project_mcp_json_path() {
-    return join(get_current_project_path(), '.mcp.json');
-}
-/**
- * Get the path to the global .mcp.json in home directory (user scope)
- */
-export function get_global_mcp_json_path() {
-    return join(homedir(), '.mcp.json');
-}
-export function get_plugins_dir() {
-    return join(get_base_dir().baseDir, 'plugins');
-}
-export function get_installed_plugins_path() {
-    return join(get_plugins_dir(), 'installed_plugins.json');
-}
-export function get_known_marketplaces_path() {
-    return join(get_plugins_dir(), 'known_marketplaces.json');
-}
-export function get_plugin_cache_dir() {
-    return join(get_plugins_dir(), 'cache');
-}
-export function get_marketplaces_dir() {
-    return join(get_plugins_dir(), 'marketplaces');
-}
-export function get_disabled_hooks_path() {
-    return join(get_mcpick_dir(), 'disabled-hooks.json');
-}
-export function get_marketplace_manifest_path(name) {
-    return join(get_marketplaces_dir(), name, '.claude-plugin', 'marketplace.json');
-}
-//# sourceMappingURL=paths.js.map