projecta-rrr 1.6.0 → 1.6.2

package/README.md

@@ -77,6 +77,13 @@ npx projecta-rrr
 
 That's it. Verify with `/rrr:help` inside your Claude Code interface.
 
+> **Installed from inside Claude Code?** Slash commands won't load until you restart:
+> 1. Type `exit` to quit Claude Code
+> 2. Run `claude` again
+> 3. Then run `/rrr:help`
+>
+> This resolves "Unknown skill: rrr:help" errors.
+
 ### Staying Updated
 
 RRR evolves fast. Check for updates periodically:
@@ -219,6 +226,71 @@ If you choose a non-default provider, RRR asks for a reason and records it in De
 
 These are allowed but require explicit justification: Firebase, Supabase, Auth0, Vercel, PlanetScale.
 
+### MCP Auto-Setup
+
+RRR includes an MCP registry that maps your selected providers to their MCP servers. After `/rrr:new-project` generates your `MVP_FEATURES.yml`:
+
+```bash
+npm run mcp:setup
+```
+
+This reads your feature selections and outputs the MCP configuration for Claude Code. Only MCPs you actually need get installed.
+
+| Feature | MCP Server |
+|---------|------------|
+| Database (Neon) | `@neondatabase/mcp-server-neon` |
+| Payments (Stripe) | `@stripe/mcp` |
+| Analytics (PostHog) | `@anthropic/mcp-posthog` |
+| Voice (Deepgram) | `@deepgram/mcp-server` |
+| Browser (Browserbase) | `@anthropic/mcp-browserbase` |
+| Sandbox (E2B) | `@e2b/mcp-server` |
+| Storage (R2) | `@cloudflare/mcp-server-r2` |
+
+**Always included:** Context7 (docs), GitHub, Filesystem, Sequential Thinking.
+
+### Pushpa Mode (Autopilot)
+
+Run phases overnight while you sleep. Pushpa Mode is an unattended runner that plans and executes phases sequentially, skipping any that require human verification.
+
+```bash
+bash scripts/pushpa-mode.sh
+# or
+npm run pushpa
+```
+
+**What it does:**
+1. Preflights required API keys based on your `MVP_FEATURES.yml`
+2. Iterates through phases in order
+3. Plans any phase that doesn't have a plan yet
+4. Executes phases automatically
+5. **Skips** phases marked with `HITL_REQUIRED: true` (human verification needed)
+6. Generates a morning report at `.planning/PUSHPA_REPORT.md`
+
+**Prerequisites:**
+- Run `/rrr:new-project` first (project must be initialized)
+- Set all required API keys (script will check and warn)
+- Recommend enabling YOLO mode in `.planning/config.json`
+
+**Where outputs live:**
+- Report: `.planning/PUSHPA_REPORT.md`
+- Logs: `.planning/logs/pushpa_*.log`
+
+**HITL Convention:**
+Plans that require human verification should include one of these markers:
+- `HITL_REQUIRED: true` (canonical)
+- `HUMAN_VERIFICATION_REQUIRED`
+- `MANUAL_VERIFICATION`
+
+Pushpa Mode will skip these phases and record them in the report for manual follow-up.
+
+**Where to run Pushpa Mode:**
+- **Recommended:** Run in a normal system terminal (outside Claude Code) for true unattended overnight runs:
+  ```bash
+  bash scripts/pushpa-mode.sh
+  ```
+- Running inside Claude Code works but can trigger approval prompts ("Do you want to proceed?").
+- If the script detects Claude Code, it will prompt: `Continue running Pushpa Mode inside Claude Code? (y/N)` — default is **No** (recommended), so you can switch to an external terminal.
+
 ---
 
 ## How It Works
@@ -453,9 +525,10 @@ You're never locked in. The system adapts.
 
 ## Troubleshooting
 
-**Commands not found after install?**
-- Restart Claude Code to reload slash commands
+**Commands not found after install/update?**
+- Restart Claude Code: type `exit`, then run `claude` again
 - Verify files exist in `~/.claude/commands/rrr/` (global) or `./.claude/commands/rrr/` (local)
+- Still seeing "Unknown skill"? Reinstall with `npx projecta-rrr@latest`, then restart `claude`
 
 **Commands not working as expected?**
 - Run `/rrr:help` to verify installation

package/bin/install.js

@@ -301,7 +301,26 @@ function finishInstall(settingsPath, settings, statuslineCommand, notifyCommand,
   writeSettings(settingsPath, settings);
 
   console.log(`
-  ${green}Done!${reset} Launch Claude Code and run ${cyan}/rrr:help${reset}.
+  ${green}Done!${reset}
+
+  ${yellow}If you installed from inside Claude Code:${reset}
+  Type ${cyan}exit${reset} and restart ${cyan}claude${reset} so it reloads commands.
+
+  ${yellow}Pick your start command:${reset}
+
+  ${cyan}New/empty folder (greenfield)${reset}
+    /rrr:new-project
+    (bootstraps Next.js/TS baseline if folder is empty)
+
+  ${cyan}Existing repo (brownfield)${reset}
+    /rrr:new-project
+    (brownfield-safe; won't overwrite or restructure your repo)
+
+  ${cyan}RRR already initialized${reset}
+    /rrr:progress
+    (if .planning/STATE.md exists)
+
+  Run ${cyan}/rrr:help${reset} anytime to see all commands.
 `);
 }
 

package/commands/rrr/help.md

@@ -19,6 +19,22 @@ Output ONLY the reference content below. Do NOT add:
 
 **RRR** creates hierarchical project plans optimized for solo agentic development with Claude Code. Built by [Projecta.ai](https://projecta.ai).
 
+## Getting Started
+
+**After install/update:** If you installed from inside Claude Code, type `exit` and restart `claude` so it reloads commands.
+
+**Still seeing "Unknown skill"?** Reinstall with `npx projecta-rrr@latest`, then restart `claude` again.
+
+**Pick your start command:**
+
+| Scenario | Command |
+|----------|---------|
+| New/empty folder (greenfield) | `/rrr:new-project` — bootstraps Next.js/TS baseline if folder is empty |
+| Existing repo (brownfield) | `/rrr:new-project` — brownfield-safe; won't overwrite your repo |
+| RRR already initialized | `/rrr:progress` — if `.planning/STATE.md` exists |
+
+**MVP Definition of Done at Projecta:** local demo runs + tests pass.
+
 ## Quick Start
 
 1. `/rrr:new-project` - Initialize project (includes research, requirements, roadmap)
@@ -381,6 +397,30 @@ Change anytime by editing `.planning/config.json`
 
 That's it! `/rrr:new-project` handles everything from bootstrap to roadmap.
 
+**Overnight mode: Pushpa Mode**
+
+Run phases unattended while you sleep:
+
+```
+bash scripts/pushpa-mode.sh
+# or
+npm run pushpa
+```
+
+Prerequisites:
+1. Run `/rrr:new-project` first
+2. Set all required API keys (based on your MVP_FEATURES.yml)
+3. Recommend enabling YOLO mode in config.json
+
+Pushpa Mode will:
+- Plan and execute phases sequentially
+- Skip phases marked with `HITL_REQUIRED: true`
+- Generate report at `.planning/PUSHPA_REPORT.md`
+- Log everything to `.planning/logs/`
+
+**Where to run:** Recommended outside Claude Code for true unattended runs.
+Running inside Claude Code may prompt for approvals; if prompted, type `y` to continue or exit and run in a normal terminal.
+
 **Bootstrap only (no planning):**
 
 ```

package/commands/rrr/new-project.md

@@ -350,15 +350,17 @@ Use AskUserQuestion:
 - header: "Preset"
 - question: "Start with a use-case preset? This pre-configures capabilities."
 - options:
+  - "saas-dashboard (Recommended)" — SaaS with Clerk + Neon + optional Stripe (DEFAULT)
   - "landing-waitlist" — Landing page + email capture (no auth, no db)
-  - "saas-dashboard" — SaaS with Clerk + Neon + optional Stripe
   - "api-admin" — API backend + admin panel (Neon, optional auth)
   - "voice-agent" — Voice AI agent (Deepgram + full agent stack)
-  - "None" — Configure capabilities manually (Recommended for custom)
+  - "Custom" — Configure capabilities manually
 
 **If preset selected:** Load preset defaults, skip to Step 3 (confirm/override).
 
-**If "None":** Continue to Step 2.
+**If "Custom":** Continue to Step 2.
+
+**DEFAULT BEHAVIOR:** If user selects nothing or skips, assume `saas-dashboard` preset (Neon + Clerk + Render + optional Stripe).
 
 ### Step 2: Capability Questionnaire
 
@@ -496,6 +498,10 @@ Deviations: [count or "None"]
 
 File: .planning/MVP_FEATURES.yml
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+💡 To configure MCP servers for your stack:
+   npm run mcp:setup
+   (Reads MVP_FEATURES.yml and installs required MCPs)
 ```
 
 Continue to Phase 3.
@@ -1272,6 +1278,16 @@ Present completion with next steps:
 
 <sub>`/clear` first → fresh context window</sub>
 
+───────────────────────────────────────────────────────────────
+
+## 🔌 MCP Setup (Optional)
+
+Configure Claude Code with MCP servers for your selected stack:
+
+`npm run mcp:setup`
+
+<sub>Reads MVP_FEATURES.yml and outputs MCP configuration</sub>
+
 ───────────────────────────────────────────────────────────────
 ```
 

package/mcp.registry.json

@@ -0,0 +1,128 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "description": "MCP server registry - maps providers to their Claude MCP installation commands",
+  "version": "1.0.0",
+
+  "servers": {
+    "neon": {
+      "name": "Neon MCP Server",
+      "description": "PostgreSQL database operations via Neon",
+      "command": "npx -y @neondatabase/mcp-server-neon",
+      "envRequired": ["NEON_API_KEY"],
+      "featureKeys": ["db:neon", "database"],
+      "docs": "https://neon.tech/docs/ai/mcp"
+    },
+
+    "stripe": {
+      "name": "Stripe MCP Server",
+      "description": "Payment processing and subscription management",
+      "command": "npx -y @stripe/mcp",
+      "envRequired": ["STRIPE_SECRET_KEY"],
+      "featureKeys": ["payments:stripe", "payments"],
+      "docs": "https://docs.stripe.com/mcp"
+    },
+
+    "posthog": {
+      "name": "PostHog MCP Server",
+      "description": "Product analytics and feature flags",
+      "command": "npx -y @anthropic/mcp-posthog",
+      "envRequired": ["POSTHOG_API_KEY", "POSTHOG_PROJECT_ID"],
+      "featureKeys": ["analytics:posthog", "analytics"],
+      "docs": "https://posthog.com/docs/mcp"
+    },
+
+    "deepgram": {
+      "name": "Deepgram MCP Server",
+      "description": "Voice-to-text and text-to-speech",
+      "command": "npx -y @deepgram/mcp-server",
+      "envRequired": ["DEEPGRAM_API_KEY"],
+      "featureKeys": ["voice:deepgram", "voice"],
+      "docs": "https://developers.deepgram.com/docs/mcp"
+    },
+
+    "browserbase": {
+      "name": "Browserbase MCP Server",
+      "description": "Headless browser automation",
+      "command": "npx -y @anthropic/mcp-browserbase",
+      "envRequired": ["BROWSERBASE_API_KEY", "BROWSERBASE_PROJECT_ID"],
+      "featureKeys": ["browserAutomation:browserbase", "browser"],
+      "docs": "https://docs.browserbase.com/mcp"
+    },
+
+    "e2b": {
+      "name": "E2B MCP Server",
+      "description": "Code execution sandbox",
+      "command": "npx -y @e2b/mcp-server",
+      "envRequired": ["E2B_API_KEY"],
+      "featureKeys": ["sandbox:e2b", "sandbox"],
+      "docs": "https://e2b.dev/docs/mcp"
+    },
+
+    "cloudflare-r2": {
+      "name": "Cloudflare R2 MCP Server",
+      "description": "S3-compatible object storage",
+      "command": "npx -y @cloudflare/mcp-server-r2",
+      "envRequired": ["CLOUDFLARE_ACCOUNT_ID", "R2_ACCESS_KEY_ID", "R2_SECRET_ACCESS_KEY"],
+      "featureKeys": ["objectStorage:r2", "storage"],
+      "docs": "https://developers.cloudflare.com/r2/mcp"
+    },
+
+    "context7": {
+      "name": "Context7 MCP Server",
+      "description": "Documentation lookup and library references",
+      "command": "npx -y @upstash/context7-mcp",
+      "envRequired": [],
+      "featureKeys": ["docs", "context"],
+      "docs": "https://context7.dev",
+      "alwaysInclude": true
+    },
+
+    "resend": {
+      "name": "Resend MCP Server",
+      "description": "Transactional email sending",
+      "command": "npx -y @resend/mcp-server",
+      "envRequired": ["RESEND_API_KEY"],
+      "featureKeys": ["email:resend", "email"],
+      "docs": "https://resend.com/docs/mcp"
+    },
+
+    "github": {
+      "name": "GitHub MCP Server",
+      "description": "GitHub repository operations",
+      "command": "npx -y @modelcontextprotocol/server-github",
+      "envRequired": ["GITHUB_PERSONAL_ACCESS_TOKEN"],
+      "featureKeys": ["github", "vcs"],
+      "docs": "https://modelcontextprotocol.io/docs/servers/github",
+      "alwaysInclude": true
+    },
+
+    "filesystem": {
+      "name": "Filesystem MCP Server",
+      "description": "Local filesystem operations",
+      "command": "npx -y @modelcontextprotocol/server-filesystem",
+      "envRequired": [],
+      "featureKeys": ["filesystem"],
+      "docs": "https://modelcontextprotocol.io/docs/servers/filesystem",
+      "alwaysInclude": true
+    },
+
+    "sequential-thinking": {
+      "name": "Sequential Thinking MCP Server",
+      "description": "Enhanced reasoning and chain-of-thought",
+      "command": "npx -y @modelcontextprotocol/server-sequential-thinking",
+      "envRequired": [],
+      "featureKeys": ["reasoning"],
+      "docs": "https://modelcontextprotocol.io/docs/servers/sequential-thinking",
+      "alwaysInclude": true
+    }
+  },
+
+  "presetMappings": {
+    "saas-dashboard": ["neon", "context7", "github", "filesystem", "sequential-thinking"],
+    "landing-waitlist": ["context7", "github", "filesystem", "sequential-thinking"],
+    "api-admin": ["neon", "context7", "github", "filesystem", "sequential-thinking"],
+    "voice-agent": ["neon", "deepgram", "e2b", "context7", "github", "filesystem", "sequential-thinking"]
+  },
+
+  "defaultServers": ["context7", "github", "filesystem", "sequential-thinking"]
+}

package/package.json

@@ -1,16 +1,23 @@
 {
   "name": "projecta-rrr",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code by Projecta.ai",
   "bin": {
     "projecta-rrr": "bin/install.js"
   },
+  "scripts": {
+    "mcp:setup": "bash scripts/mcp-setup.sh",
+    "pushpa": "bash scripts/pushpa-mode.sh"
+  },
   "files": [
     "bin",
     "commands",
     "rrr",
     "agents",
-    "hooks"
+    "hooks",
+    "scripts",
+    "mcp.registry.json",
+    "projecta.defaults.json"
   ],
   "keywords": [
     "claude",

package/projecta.defaults.json

@@ -0,0 +1,32 @@
+{
+  "framework": "nextjs-app-router",
+  "language": "typescript",
+  "packageManager": "npm",
+  "ui": {
+    "styling": "tailwind",
+    "componentSystem": "shadcn-ui"
+  },
+  "testing": {
+    "unit": "vitest",
+    "e2e": "playwright"
+  },
+  "preferredProviders": {
+    "db": ["neon"],
+    "auth": ["clerk", "neon-auth"],
+    "authDefault": "clerk",
+    "deploy": ["render"],
+    "payments": ["stripe"],
+    "objectStorage": ["r2"],
+    "analytics": ["posthog"],
+    "voice": ["deepgram"],
+    "agents": ["mastra"],
+    "agentAuth": ["authdev"],
+    "agentMail": ["agentmail"],
+    "sandbox": ["e2b"],
+    "browserAutomation": ["browserbase"]
+  },
+  "discouragedProviders": {
+    "list": ["firebase", "supabase", "auth0", "vercel", "planetscale"],
+    "note": "These providers are discouraged but allowed with explicit reason recorded in Deviation Notes"
+  }
+}

package/rrr/presets/saas-dashboard.yml

@@ -1,7 +1,9 @@
-# SaaS Dashboard Preset
+# SaaS Dashboard Preset (DEFAULT)
 # Auth + database required, payments optional
+# This is the Projecta default preset - used when user skips selection
 
 name: saas-dashboard
+default: true
 description: SaaS application with authentication, database, and optional payments
 
 stack:
@@ -70,6 +72,10 @@ database:
     - users (synced from Clerk)
     - user_data (application-specific)
 
+# MCP servers auto-installed based on integrations
+mcp_servers:
+  - neon  # Required for database
+
 done_criteria:
   - User can sign up and sign in
   - Dashboard only accessible when authenticated

package/scripts/mcp-setup.sh

@@ -0,0 +1,224 @@
+#!/bin/bash
+#
+# MCP Setup Script for Projecta RRR
+# Reads MVP_FEATURES.yml and generates MCP server configuration
+#
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+echo ""
+echo -e "${CYAN}╔══════════════════════════════════════════╗${NC}"
+echo -e "${CYAN}║    Projecta RRR - MCP Setup              ║${NC}"
+echo -e "${CYAN}╚══════════════════════════════════════════╝${NC}"
+echo ""
+
+# Find the RRR installation directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+RRR_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Check if we're in a project with .planning
+PROJECT_DIR="$(pwd)"
+FEATURES_FILE="$PROJECT_DIR/.planning/MVP_FEATURES.yml"
+REGISTRY_FILE="$RRR_DIR/mcp.registry.json"
+
+# Verify registry exists
+if [ ! -f "$REGISTRY_FILE" ]; then
+    echo -e "${RED}Error: MCP registry not found at $REGISTRY_FILE${NC}"
+    exit 1
+fi
+
+# Determine which MCPs to include
+MCP_SERVERS=()
+
+# Always include default servers
+DEFAULT_SERVERS=$(cat "$REGISTRY_FILE" | grep -A1000 '"defaultServers"' | grep -o '"[^"]*"' | tr -d '"' | head -10)
+for server in $DEFAULT_SERVERS; do
+    if [ "$server" != "defaultServers" ] && [ "$server" != "[" ] && [ "$server" != "]" ]; then
+        MCP_SERVERS+=("$server")
+    fi
+done
+
+# Check if MVP_FEATURES.yml exists
+if [ -f "$FEATURES_FILE" ]; then
+    echo -e "${GREEN}Found MVP_FEATURES.yml${NC}"
+    echo ""
+
+    # Extract preset if specified
+    PRESET=$(grep "^preset:" "$FEATURES_FILE" 2>/dev/null | cut -d: -f2 | tr -d ' ' || echo "")
+
+    if [ -n "$PRESET" ]; then
+        echo -e "Preset: ${CYAN}$PRESET${NC}"
+
+        # Get servers for this preset from registry
+        PRESET_SERVERS=$(cat "$REGISTRY_FILE" | grep -A10 "\"$PRESET\":" | grep -o '"[^"]*"' | tr -d '"' | grep -v "$PRESET" | head -10)
+        for server in $PRESET_SERVERS; do
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " ${server} " ]]; then
+                MCP_SERVERS+=("$server")
+            fi
+        done
+    fi
+
+    # Check for specific feature selections
+    # Database
+    if grep -q "db:" "$FEATURES_FILE" 2>/dev/null; then
+        DB=$(grep "db:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$DB" = "neon" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " neon " ]]; then
+                MCP_SERVERS+=("neon")
+            fi
+        fi
+    fi
+
+    # Payments
+    if grep -q "payments:" "$FEATURES_FILE" 2>/dev/null; then
+        PAYMENTS=$(grep "payments:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$PAYMENTS" = "stripe" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " stripe " ]]; then
+                MCP_SERVERS+=("stripe")
+            fi
+        fi
+    fi
+
+    # Voice
+    if grep -q "voice:" "$FEATURES_FILE" 2>/dev/null; then
+        VOICE=$(grep "voice:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$VOICE" = "deepgram" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " deepgram " ]]; then
+                MCP_SERVERS+=("deepgram")
+            fi
+        fi
+    fi
+
+    # Analytics
+    if grep -q "analytics:" "$FEATURES_FILE" 2>/dev/null; then
+        ANALYTICS=$(grep "analytics:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$ANALYTICS" = "posthog" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " posthog " ]]; then
+                MCP_SERVERS+=("posthog")
+            fi
+        fi
+    fi
+
+    # Browser automation
+    if grep -q "browserAutomation:" "$FEATURES_FILE" 2>/dev/null; then
+        BROWSER=$(grep "browserAutomation:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$BROWSER" = "browserbase" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " browserbase " ]]; then
+                MCP_SERVERS+=("browserbase")
+            fi
+        fi
+    fi
+
+    # Sandbox
+    if grep -q "sandbox:" "$FEATURES_FILE" 2>/dev/null; then
+        SANDBOX=$(grep "sandbox:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$SANDBOX" = "e2b" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " e2b " ]]; then
+                MCP_SERVERS+=("e2b")
+            fi
+        fi
+    fi
+
+    # Object storage
+    if grep -q "objectStorage:" "$FEATURES_FILE" 2>/dev/null; then
+        STORAGE=$(grep "objectStorage:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$STORAGE" = "r2" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " cloudflare-r2 " ]]; then
+                MCP_SERVERS+=("cloudflare-r2")
+            fi
+        fi
+    fi
+
+    # Email
+    if grep -q "email:" "$FEATURES_FILE" 2>/dev/null; then
+        EMAIL=$(grep "email:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$EMAIL" = "resend" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " resend " ]]; then
+                MCP_SERVERS+=("resend")
+            fi
+        fi
+    fi
+else
+    echo -e "${YELLOW}No MVP_FEATURES.yml found - using SaaS default preset${NC}"
+    echo ""
+    # Add neon for SaaS default
+    MCP_SERVERS+=("neon")
+fi
+
+echo ""
+echo -e "${GREEN}MCP Servers for your stack:${NC}"
+echo "─────────────────────────────"
+
+# Output the MCP configuration
+for server in "${MCP_SERVERS[@]}"; do
+    # Get server details from registry
+    SERVER_NAME=$(cat "$REGISTRY_FILE" | grep -A5 "\"$server\":" | grep '"name"' | cut -d'"' -f4)
+    SERVER_CMD=$(cat "$REGISTRY_FILE" | grep -A5 "\"$server\":" | grep '"command"' | cut -d'"' -f4)
+
+    if [ -n "$SERVER_CMD" ]; then
+        echo -e "  ${CYAN}$server${NC}: $SERVER_NAME"
+        echo -e "    Command: ${YELLOW}$SERVER_CMD${NC}"
+    fi
+done
+
+echo ""
+echo "─────────────────────────────"
+echo ""
+echo -e "${GREEN}To configure Claude Code with these MCPs:${NC}"
+echo ""
+echo "1. Open Claude Code settings:"
+echo -e "   ${CYAN}claude config${NC}"
+echo ""
+echo "2. Add MCP servers manually, or add to your ~/.claude/settings.json:"
+echo ""
+
+# Generate JSON snippet
+echo -e "${YELLOW}{"
+echo '  "mcpServers": {'
+
+FIRST=true
+for server in "${MCP_SERVERS[@]}"; do
+    SERVER_CMD=$(cat "$REGISTRY_FILE" | grep -A5 "\"$server\":" | grep '"command"' | cut -d'"' -f4)
+    if [ -n "$SERVER_CMD" ]; then
+        if [ "$FIRST" = true ]; then
+            FIRST=false
+        else
+            echo ","
+        fi
+        # Extract the package name from the npx command
+        PKG_NAME=$(echo "$SERVER_CMD" | sed 's/npx -y //')
+        echo -n "    \"$server\": {"
+        echo -n "\"command\": \"npx\", \"args\": [\"-y\", \"$PKG_NAME\"]"
+        echo -n "}"
+    fi
+done
+
+echo ""
+echo '  }'
+echo -e "}${NC}"
+echo ""
+
+# List required environment variables
+echo -e "${GREEN}Required environment variables:${NC}"
+echo "─────────────────────────────"
+
+for server in "${MCP_SERVERS[@]}"; do
+    ENV_VARS=$(cat "$REGISTRY_FILE" | grep -A10 "\"$server\":" | grep -A5 '"envRequired"' | grep -o '"[A-Z_]*"' | tr -d '"')
+    if [ -n "$ENV_VARS" ]; then
+        echo -e "  ${CYAN}$server${NC}:"
+        for var in $ENV_VARS; do
+            echo "    - $var"
+        done
+    fi
+done
+
+echo ""
+echo -e "${GREEN}Done!${NC} Add the environment variables to your .env file."
+echo ""