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

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-configured in `.mcp.json`)
 - **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 MCP configuration is written to `.mcp.json` in your project root and will be picked up by Claude Code on restart. First use will prompt for security approval.
 
 ## 📖 Documentation
 

package/bin/cli.js

@@ -234,10 +234,11 @@ function main() {
   }
 
   // ========================================
-  // 5. Install/Merge MCP Servers (Context7)
+  // 5. Install/Merge MCP Servers (Context7, GitHub)
   // ========================================
+  // NOTE: Claude Code uses .mcp.json in project root, NOT .claude/mcp-servers.json
   const mcpSource = path.join(sourceTemplatesDir, 'mcp-servers.json');
-  const mcpDest = path.join(claudeDir, 'mcp-servers.json');
+  const mcpDest = path.join(targetDir, '.mcp.json');
 
   if (fs.existsSync(mcpSource)) {
     log('\n🔌 Configuring MCP servers:', 'cyan');
@@ -250,17 +251,18 @@ function main() {
         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');
+        log('   ✅ Merged into existing .mcp.json', 'green');
       } else {
         // Create new MCP config file
         fs.writeFileSync(mcpDest, JSON.stringify(newMcp, null, 2));
-        log('   ✅ Created mcp-servers.json with Context7', 'green');
+        log('   ✅ Created .mcp.json in project root', 'green');
       }
 
       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');
+      log('   ⚠️  First use will prompt for security approval', 'yellow');
     } catch (error) {
       log(`   ❌ Failed to configure MCP servers: ${error.message}`, 'red');
     }
@@ -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:       .mcp.json (Context7, GitHub)', '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.2.1",
   "description": "Interview-driven API development workflow for Claude Code - Automates research, testing, and documentation",
   "main": "bin/cli.js",
   "bin": {