@hustle-together/api-dev-tools 1.2.0 → 1.3.0

package/README.md

@@ -35,7 +35,7 @@ Three Python hooks that provide **real programmatic guarantees**:
 ### State Tracking
 - **`.claude/api-dev-state.json`** - Persistent state file tracking all workflow progress
 
-### MCP Servers (Auto-configured)
+### MCP Servers (Auto-installed via `claude mcp add`)
 - **Context7** - Fetches LIVE documentation from library source code (not training data)
 - **GitHub** - Read/create issues, pull requests, and access repository data (requires `GITHUB_PERSONAL_ACCESS_TOKEN`)
 
@@ -432,7 +432,7 @@ Required for `/pr` and `/issue` commands to work with GitHub MCP tools.
 export GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token_here
 ```
 
-The MCP configuration is written to `.claude/mcp-servers.json` and will be picked up by Claude Code on restart.
+The installer runs `claude mcp add` commands directly, which registers the servers in your Claude Code config (`~/.claude.json`). Restart Claude Code after installation for MCP tools to be available.
 
 ## 📖 Documentation
 

package/bin/cli.js

@@ -234,38 +234,40 @@ function main() {
   }
 
   // ========================================
-  // 5. Install/Merge MCP Servers (Context7)
+  // 5. Install MCP Servers via CLI (Context7, GitHub)
   // ========================================
-  const mcpSource = path.join(sourceTemplatesDir, 'mcp-servers.json');
-  const mcpDest = path.join(claudeDir, 'mcp-servers.json');
+  // NOTE: We use `claude mcp add` directly because .mcp.json requires manual approval
+  // and doesn't auto-load. Using the CLI ensures servers are immediately available.
+  log('\n🔌 Configuring MCP servers:', 'cyan');
 
-  if (fs.existsSync(mcpSource)) {
-    log('\n🔌 Configuring MCP servers:', 'cyan');
+  const { execSync } = require('child_process');
 
+  const mcpServers = [
+    { name: 'context7', command: 'npx -y @upstash/context7-mcp', description: 'Live documentation from library source code' },
+    { name: 'github', command: 'npx -y @modelcontextprotocol/server-github', description: 'GitHub issues, PRs, and repository access' }
+  ];
+
+  for (const server of mcpServers) {
     try {
-      const newMcp = JSON.parse(fs.readFileSync(mcpSource, 'utf8'));
-
-      if (fs.existsSync(mcpDest)) {
-        // Merge with existing MCP config
-        const existingMcp = JSON.parse(fs.readFileSync(mcpDest, 'utf8'));
-        const mergedMcp = mergeMcpServers(existingMcp, newMcp);
-        fs.writeFileSync(mcpDest, JSON.stringify(mergedMcp, null, 2));
-        log('   ✅ Merged Context7 into existing mcp-servers.json', 'green');
-      } else {
-        // Create new MCP config file
-        fs.writeFileSync(mcpDest, JSON.stringify(newMcp, null, 2));
-        log('   ✅ Created mcp-servers.json with Context7', 'green');
+      // Check if server already exists
+      const checkResult = execSync(`claude mcp get ${server.name} 2>&1`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
+      if (checkResult.includes('Connected') || checkResult.includes('Scope:')) {
+        log(`   ✓ ${server.name} - already configured`, 'blue');
+      }
+    } catch (checkError) {
+      // Server doesn't exist, add it
+      try {
+        execSync(`claude mcp add ${server.name} -- ${server.command}`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
+        log(`   ✅ ${server.name} - ${server.description}`, 'green');
+      } catch (addError) {
+        log(`   ⚠️  ${server.name} - Could not add (run manually: claude mcp add ${server.name} -- ${server.command})`, 'yellow');
       }
-
-      log('\n   MCP servers configured:', 'blue');
-      log('   • context7 - Live documentation from library source code', 'blue');
-      log('   • github   - GitHub issues, PRs, and repository access', 'blue');
-      log('\n   ⚠️  GitHub MCP requires GITHUB_PERSONAL_ACCESS_TOKEN in env', 'yellow');
-    } catch (error) {
-      log(`   ❌ Failed to configure MCP servers: ${error.message}`, 'red');
     }
   }
 
+  log('\n   ⚠️  GitHub MCP requires GITHUB_PERSONAL_ACCESS_TOKEN in env', 'yellow');
+  log('   💡 Restart Claude Code for MCP tools to be available', 'yellow');
+
   // ========================================
   // Success Summary
   // ========================================
@@ -278,7 +280,7 @@ function main() {
   log('   Hooks:     .claude/hooks/*.py', 'blue');
   log('   Settings:  .claude/settings.json', 'blue');
   log('   State:     .claude/api-dev-state.json', 'blue');
-  log('   MCP:       .claude/mcp-servers.json (Context7, GitHub)', 'blue');
+  log('   MCP:       context7, github (via claude mcp add)', 'blue');
 
   log('\n🔒 Enforcement Features:', 'bright');
   log('   • Research MUST happen before code writing', 'cyan');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hustle-together/api-dev-tools",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Interview-driven API development workflow for Claude Code - Automates research, testing, and documentation",
   "main": "bin/cli.js",
   "bin": {