mcpick 0.0.2 → 0.0.4

package/.github/copilot-instructions.md

@@ -0,0 +1,32 @@
+# McPick Development Instructions
+
+**Always reference these instructions first and fallback to search or
+bash commands only when you encounter unexpected information that does
+not match the info here.**
+
+## Working Effectively
+
+### Prerequisites and Setup
+
+- Install Node.js >=22.0.0
+- Install pnpm globally: `npm install -g pnpm` (takes ~2 seconds)
+
+### Development Commands
+
+- **Format code**: `pnpm run format`
+- **Build**: `pnpm run build`
+
+## Validation Requirements
+
+### ALWAYS run these before submitting changes:
+
+1. `pnpm run format` - Auto-format all code
+2. `pnpm run build` - Check for build issues
+
+#### Add changeset once you're done
+
+Run `pnpm changeset` then follow the prompts. Use this after having
+finished the task. Most of the time this is a patch release for
+`mcpick`. Use a short and descriptive message. Always prefix the
+message with either `fix`, `feat`, `breaking`, or `chore` (most likely
+`fix` since you're mostly working on bugfixes).

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # mcpick
 
+## 0.0.4
+
+### Patch Changes
+
+- 25f7d07: chore: remove non-functional launch feature
+
+## 0.0.3
+
+### Patch Changes
+
+- 158520e: fix: extract duplicated server details display logic into
+  reusable function
+
 ## 0.0.2
 
 ### Patch Changes

package/README.md

@@ -1,9 +1,27 @@
-# MCPick
+# McPick
 
 A CLI tool for dynamically managing MCP server configurations in
 Claude Code. Enable and disable MCP servers on-demand to optimize
 context usage and performance.
 
+## Installation
+
+### One-time Usage
+
+```bash
+pnpm dlx mcpick
+# or
+npx mcpick
+```
+
+### Global Installation
+
+```bash
+pnpm install -g mcpick
+# or
+npm install -g mcpick
+```
+
 ## The Problem
 
 Using the Claude Code `/doctor` command you may see something like
@@ -31,7 +49,7 @@ This can lead to:
 
 ## The Solution
 
-MCPick provides an intuitive CLI menu to:
+McPick provides an intuitive CLI menu to:
 
 - ✅ **Toggle servers on/off** - Enable only the MCP servers you need
   for your current task
@@ -41,22 +59,19 @@ MCPick provides an intuitive CLI menu to:
   preserving other Claude Code settings
 - 💾 **Backup & restore** - Create focused backups of your MCP server
   configurations
-- 🚀 **Quick launch** - Start Claude Code with your optimized
-  configuration
 
 ## Features
 
 ### Interactive Menu
 
 ```bash
-┌  MCPick - MCP Server Configuration Manager
+┌  McPick - MCP Server Configuration Manager
 │
 ◆  What would you like to do?
 │  ● Edit config (Toggle MCP servers on/off)
 │  ○ Backup config
 │  ○ Add MCP server
 │  ○ Restore from backup
-│  ○ Launch Claude Code
 │  ○ Exit
 └
 ```
@@ -85,7 +100,8 @@ MCPick provides an intuitive CLI menu to:
 
 1. **Before a coding session**: Run MCPick and enable only relevant
    servers (e.g., just database tools for DB work)
-2. **Launch Claude Code**: Use MCPick's "Launch Claude Code" option
+2. **Launch Claude Code**: Run `claude` to start with your configured
+   servers
 3. **Switch contexts**: Re-run MCPick to enable different servers for
    different tasks
 

package/dist/commands/add-server.js

@@ -1,6 +1,26 @@
 import { confirm, note, select, text } from '@clack/prompts';
 import { add_server_to_registry } from '../core/registry.js';
 import { validate_mcp_server } from '../core/validation.js';
+function format_server_details(server) {
+    const details = [`Name: ${server.name}`];
+    if ('command' in server) {
+        details.push(`Command: ${server.command} ${(server.args || []).join(' ')}`);
+    }
+    if ('url' in server) {
+        details.push(`URL: ${server.url}`);
+    }
+    details.push(`Description: ${server.description || 'None'}`);
+    if (server.type) {
+        details.push(`Transport: ${server.type}`);
+    }
+    if (server.env) {
+        details.push(`Environment: ${Object.keys(server.env).length} variables`);
+    }
+    if ('headers' in server && server.headers) {
+        details.push(`Headers: ${Object.keys(server.headers).length} headers`);
+    }
+    return details;
+}
 export async function add_server() {
     try {
         // First, ask how they want to configure the server
@@ -75,6 +95,7 @@ export async function add_server() {
             return;
         let server_data = {
             name: name.trim(),
+            type: 'stdio',
             command: command.trim(),
             args,
             ...(description &&
@@ -97,11 +118,12 @@ export async function add_server() {
             });
             if (typeof transport_type === 'symbol')
                 return;
-            if (transport_type !== 'stdio') {
-                server_data.type = transport_type;
-            }
+            server_data.type = transport_type;
             // URL for non-stdio transports
-            if (transport_type !== 'stdio') {
+            if (transport_type === 'sse' || transport_type === 'http') {
+                // Remove stdio-specific fields
+                delete server_data.command;
+                delete server_data.args;
                 const url = await text({
                     message: 'Server URL:',
                     placeholder: 'e.g., http://localhost:3000',
@@ -158,10 +180,8 @@ export async function add_server() {
             }
         }
         const validated_server = validate_mcp_server(server_data);
-        note(`Server to add:\n` +
-            `Name: ${validated_server.name}\n` +
-            `Command: ${validated_server.command} ${validated_server.args.join(' ')}\n` +
-            `Description: ${validated_server.description || 'None'}`);
+        const details = format_server_details(validated_server);
+        note(`Server to add:\n${details.join('\n')}`);
         const should_add = await confirm({
             message: 'Add this server to the registry?',
         });
@@ -213,23 +233,20 @@ async function add_server_from_json() {
         }
         const parsed = JSON.parse(jsonString);
         const server_data = parsed;
+        // Normalize the data to match schema expectations
+        if (!server_data.type && server_data.command) {
+            server_data.type = 'stdio';
+        }
+        if (server_data.type !== 'stdio') {
+            delete server_data.command;
+            delete server_data.args;
+        }
+        if (server_data.command && !server_data.args) {
+            server_data.args = [];
+        }
         const validated_server = validate_mcp_server(server_data);
-        note(`Server to add:\n` +
-            `Name: ${validated_server.name}\n` +
-            `Command: ${validated_server.command} ${validated_server.args.join(' ')}\n` +
-            `Description: ${validated_server.description || 'None'}` +
-            (validated_server.type
-                ? `\nTransport: ${validated_server.type}`
-                : '') +
-            (validated_server.url
-                ? `\nURL: ${validated_server.url}`
-                : '') +
-            (validated_server.env
-                ? `\nEnvironment: ${Object.keys(validated_server.env).length} variables`
-                : '') +
-            (validated_server.headers
-                ? `\nHeaders: ${Object.keys(validated_server.headers).length} headers`
-                : ''));
+        const details = format_server_details(validated_server);
+        note(`Server to add:\n${details.join('\n')}`);
         const should_add = await confirm({
             message: 'Add this server to the registry?',
         });

package/dist/commands/launch.js

@@ -1,31 +1,20 @@
-import { spinner } from '@clack/prompts';
-import { spawn } from 'node:child_process';
+import { outro } from '@clack/prompts';
+import { execSync } from 'node:child_process';
 export async function launch_claude_code() {
-    const s = spinner();
     try {
-        s.start('Launching Claude Code...');
-        const claude_process = spawn('claude', ['code'], {
+        outro('Launching Claude Code...');
+        // Replace the current process with claude using exec
+        // This ensures the terminal stays valid and Claude gets full control
+        execSync('claude', {
             stdio: 'inherit',
-            detached: true,
         });
-        claude_process.unref();
-        await new Promise((resolve, reject) => {
-            claude_process.on('error', (error) => {
-                if (error.message.includes('ENOENT')) {
-                    reject(new Error('Claude Code not found. Make sure it is installed and in your PATH.'));
-                }
-                else {
-                    reject(error);
-                }
-            });
-            setTimeout(() => {
-                resolve(void 0);
-            }, 1000);
-        });
-        s.stop('Claude Code launched successfully!');
     }
     catch (error) {
-        s.stop('Failed to launch Claude Code');
+        if (error instanceof Error && 'status' in error) {
+            // Claude exited normally, just return
+            return;
+        }
+        // Only throw for actual errors (not exit codes)
         throw new Error(`Failed to launch Claude Code: ${error instanceof Error ? error.message : 'Unknown error'}`);
     }
 }

package/dist/core/validation.js

@@ -1,32 +1,38 @@
 import * as v from 'valibot';
-export const mcp_server_schema = v.object({
-    name: v.pipe(v.string(), v.minLength(1)),
-    type: v.optional(v.union([
-        v.literal('stdio'),
-        v.literal('sse'),
-        v.literal('http'),
-    ])),
+export const mcp_server_schema_stdio = v.object({
+    type: v.optional(v.literal('stdio')),
     command: v.pipe(v.string(), v.minLength(1)),
-    args: v.array(v.string()),
+    args: v.optional(v.array(v.string())),
     env: v.optional(v.record(v.string(), v.string())),
-    url: v.optional(v.string()),
+    description: v.optional(v.string()),
+});
+export const mcp_server_schema_sse = v.object({
+    type: v.literal('sse'),
+    env: v.optional(v.record(v.string(), v.string())),
+    url: v.pipe(v.string(), v.minLength(1)),
+    headers: v.optional(v.record(v.string(), v.string())),
+    description: v.optional(v.string()),
+});
+export const mcp_server_schema_http = v.object({
+    type: v.literal('http'),
+    env: v.optional(v.record(v.string(), v.string())),
+    url: v.pipe(v.string(), v.minLength(1)),
     headers: v.optional(v.record(v.string(), v.string())),
     description: v.optional(v.string()),
 });
+export const mcp_server_schema_base = v.union([
+    mcp_server_schema_stdio,
+    mcp_server_schema_sse,
+    mcp_server_schema_http,
+]);
+export const mcp_server_schema = v.intersect([
+    v.object({
+        name: v.pipe(v.string(), v.minLength(1)),
+    }),
+    mcp_server_schema_base,
+]);
 export const claude_config_schema = v.object({
-    mcpServers: v.optional(v.record(v.string(), v.object({
-        type: v.optional(v.union([
-            v.literal('stdio'),
-            v.literal('sse'),
-            v.literal('http'),
-        ])),
-        command: v.pipe(v.string(), v.minLength(1)),
-        args: v.array(v.string()),
-        env: v.optional(v.record(v.string(), v.string())),
-        url: v.optional(v.string()),
-        headers: v.optional(v.record(v.string(), v.string())),
-        description: v.optional(v.string()),
-    }))),
+    mcpServers: v.optional(v.record(v.string(), mcp_server_schema_base)),
 });
 export const server_registry_schema = v.object({
     servers: v.array(mcp_server_schema),

package/dist/index.js

@@ -3,7 +3,6 @@ import { cancel, intro, isCancel, outro, select, } from '@clack/prompts';
 import { add_server } from './commands/add-server.js';
 import { backup_config } from './commands/backup.js';
 import { edit_config } from './commands/edit-config.js';
-import { launch_claude_code } from './commands/launch.js';
 import { restore_config } from './commands/restore.js';
 async function main() {
     intro('MCPick - MCP Server Configuration Manager');
@@ -32,15 +31,10 @@ async function main() {
                         label: 'Restore from backup',
                         hint: 'Restore from a previous backup',
                     },
-                    {
-                        value: 'launch',
-                        label: 'Launch Claude Code',
-                        hint: 'Start Claude Code with current config',
-                    },
                     {
                         value: 'exit',
                         label: 'Exit',
-                        hint: 'Quit MCPick',
+                        hint: 'Quit MCPick (Esc)',
                     },
                 ],
             });
@@ -61,9 +55,6 @@ async function main() {
                 case 'restore':
                     await restore_config();
                     break;
-                case 'launch':
-                    await launch_claude_code();
-                    break;
                 case 'exit':
                     outro('Goodbye!');
                     process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpick",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Dynamic MCP server configuration manager for Claude Code",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,9 +25,9 @@
   },
   "devDependencies": {
     "@changesets/cli": "^2.29.7",
-    "@types/node": "^24.5.2",
+    "@types/node": "^24.6.1",
     "prettier": "^3.6.2",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.3"
   },
   "scripts": {
     "build": "tsc",