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

package/README.md

@@ -35,6 +35,10 @@ 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 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`)
+
 ## 🎯 Why Use This?
 
 ### Problems This Solves
@@ -405,6 +409,31 @@ The `.claude/api-dev-state.json` file tracks:
 - **Claude Code** (CLI tool for Claude)
 - **Project structure** with `.claude/commands/` support
 
+## 🔌 MCP Servers
+
+This package auto-configures two MCP servers:
+
+### Context7
+- **Live documentation lookup** from library source code
+- **Current API parameters** (not outdated training data)
+- **TypeScript type definitions** directly from packages
+
+When you research a library like `@ai-sdk/core`, Context7 fetches the actual current documentation rather than relying on Claude's training data which may be outdated.
+
+### GitHub
+- **Issue management** - Read and create GitHub issues
+- **Pull requests** - Create PRs with proper formatting
+- **Repository access** - Browse repo contents and metadata
+
+Required for `/pr` and `/issue` commands to work with GitHub MCP tools.
+
+**Setup:** Set `GITHUB_PERSONAL_ACCESS_TOKEN` in your environment:
+```bash
+export GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token_here
+```
+
+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
 
 After installation, see:

package/bin/cli.js

@@ -233,6 +233,41 @@ function main() {
     }
   }
 
+  // ========================================
+  // 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(targetDir, '.mcp.json');
+
+  if (fs.existsSync(mcpSource)) {
+    log('\n🔌 Configuring MCP servers:', 'cyan');
+
+    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 into existing .mcp.json', 'green');
+      } else {
+        // Create new MCP config file
+        fs.writeFileSync(mcpDest, JSON.stringify(newMcp, null, 2));
+        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');
+    }
+  }
+
   // ========================================
   // Success Summary
   // ========================================
@@ -245,6 +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:       .mcp.json (Context7, GitHub)', 'blue');
 
   log('\n🔒 Enforcement Features:', 'bright');
   log('   • Research MUST happen before code writing', 'cyan');
@@ -279,6 +315,25 @@ function main() {
   }
 }
 
+/**
+ * Merge MCP server configurations
+ */
+function mergeMcpServers(existing, newMcp) {
+  const merged = { ...existing };
+  merged.mcpServers = merged.mcpServers || {};
+
+  // Add new MCP servers that don't already exist
+  if (newMcp.mcpServers) {
+    for (const [name, config] of Object.entries(newMcp.mcpServers)) {
+      if (!merged.mcpServers[name]) {
+        merged.mcpServers[name] = config;
+      }
+    }
+  }
+
+  return merged;
+}
+
 /**
  * Merge two settings objects, combining hooks arrays
  */

package/package.json

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

package/templates/mcp-servers.json

@@ -0,0 +1,15 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": ""
+      }
+    }
+  }
+}