mcpick 0.0.2 → 0.0.3

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,12 @@
 # mcpick
 
+## 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
@@ -49,7 +67,7 @@ MCPick provides an intuitive CLI menu to:
 ### 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)

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

@@ -5,7 +5,7 @@ export async function launch_claude_code() {
     try {
         s.start('Launching Claude Code...');
         const claude_process = spawn('claude', ['code'], {
-            stdio: 'inherit',
+            stdio: 'ignore',
             detached: true,
         });
         claude_process.unref();

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

@@ -40,7 +40,7 @@ async function main() {
                     {
                         value: 'exit',
                         label: 'Exit',
-                        hint: 'Quit MCPick',
+                        hint: 'Quit MCPick (Esc)',
                     },
                 ],
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpick",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "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",