burnrate 0.1.6 → 0.1.8

package/README.md

@@ -41,21 +41,23 @@ The players who learn to work WITH Claude—analyzing intel, optimizing routes,
 
 ## Quick Start
 
-**One command to set up, then you're in.**
+**Create a directory, run setup, start playing.**
 
 ```bash
+mkdir burnrate && cd burnrate
 npx burnrate setup
+claude
 ```
 
-The setup wizard connects to the live server, auto-configures your Claude Code MCP settings, and verifies the connection.
+The setup wizard connects to the live server, writes a `.mcp.json` config in the current directory, and verifies the connection. Then start Claude Code from that directory.
 
-**Restart Claude Code**, then tell Claude:
+Tell Claude:
 
 ```
 Use burnrate_join to create a character named "YourName"
 ```
 
-You'll get an API key. Run `npx burnrate setup` again and paste it in, or manually add `"BURNRATE_API_KEY": "your-key"` to the env block in `~/.claude/settings.json`. Restart Claude Code one more time, and you're set.
+You'll get an API key. Run `npx burnrate setup` again and paste it in, or manually add `"BURNRATE_API_KEY": "your-key"` to the env block in `.mcp.json`. Restart Claude Code and you're set.
 
 ### Setup from Source (Alternative)
 
@@ -69,14 +71,15 @@ npm run setup
 
 ### Manual Config (Alternative)
 
-Add this directly to `~/.claude/settings.json`:
+Create a `.mcp.json` file in any directory you'll run Claude Code from:
 
 ```json
 {
   "mcpServers": {
     "burnrate": {
+      "type": "stdio",
       "command": "npx",
-      "args": ["-y", "burnrate", "start"],
+      "args": ["-y", "burnrate", "mcp"],
       "env": {
         "BURNRATE_API_URL": "https://burnrate-api-server-production.up.railway.app",
         "BURNRATE_API_KEY": "your-key-here"

package/dist/cli/index.js

@@ -13,9 +13,10 @@ if (process.argv[2] === 'setup') {
 }
 if (process.argv[2] === 'mcp') {
     await import('../mcp/server.js');
-    // MCP server runs indefinitely via stdio, so this line is only
-    // reached if the server exits on its own
-    process.exit(0);
+    // server.connect() resolves immediately after setting up the transport,
+    // so we block here to prevent fallthrough to heavy imports.
+    // Node exits naturally when the MCP client closes stdin.
+    await new Promise(() => { });
 }
 // Heavy imports — only reached when NOT running setup
 const { Command } = await import('commander');

package/dist/cli/setup.js

@@ -7,7 +7,6 @@
  */
 import fs from 'fs';
 import path from 'path';
-import os from 'os';
 import readline from 'readline';
 const rl = readline.createInterface({
     input: process.stdin,
@@ -72,64 +71,65 @@ async function main() {
             console.log('  ⚠ Could not validate key (server unreachable).');
         }
     }
-    // 5. Determine MCP server config
-    // Detect whether we're running from source (git clone) or npx
+    // 5. Determine MCP server command
+    // Detect whether we're running from source (git clone) or npm install
     const distPath = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..', 'mcp', 'server.js');
     const isFromSource = !distPath.includes('node_modules');
     let mcpCommand;
     let mcpArgs;
     if (isFromSource && fs.existsSync(distPath)) {
-        // Running from cloned source — use direct path
+        // Running from cloned source — use direct node path
         mcpCommand = 'node';
         mcpArgs = [distPath];
         console.log(`\nMCP server: ${distPath} (source)`);
     }
     else {
-        // Installed via npx/npm — use npx to resolve package at runtime
-        // This is stable and doesn't depend on ephemeral npx cache paths
-        mcpCommand = 'npx';
-        mcpArgs = ['-y', 'burnrate', 'mcp'];
-        console.log(`\nMCP server: npx burnrate mcp (npm package)`);
-    }
-    // 6. Write Claude Code settings
-    const claudeSettingsDir = path.join(os.homedir(), '.claude');
-    const claudeSettingsPath = path.join(claudeSettingsDir, 'settings.json');
-    let settings = {};
-    if (fs.existsSync(claudeSettingsPath)) {
-        try {
-            settings = JSON.parse(fs.readFileSync(claudeSettingsPath, 'utf-8'));
+        // Installed via npx/npm — find the global or local node + server path
+        // Using absolute paths is most reliable for MCP servers
+        const nodePath = process.execPath; // absolute path to current node binary
+        // Resolve the server.js path relative to this setup script
+        const serverPath = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..', 'mcp', 'server.js');
+        if (fs.existsSync(serverPath)) {
+            mcpCommand = nodePath;
+            mcpArgs = [serverPath];
+            console.log(`\nMCP server: ${serverPath}`);
         }
-        catch {
-            console.log('  ⚠ Could not parse existing settings.json, creating new one.');
+        else {
+            // Fallback: use npx
+            mcpCommand = 'npx';
+            mcpArgs = ['-y', 'burnrate', 'mcp'];
+            console.log(`\nMCP server: npx burnrate mcp (npm package)`);
         }
     }
-    if (!settings.mcpServers) {
-        settings.mcpServers = {};
-    }
+    // 6. Write .mcp.json in the current directory
+    // Claude Code reads MCP server config from .mcp.json at the project level
+    const mcpConfigPath = path.join(process.cwd(), '.mcp.json');
     const env = {
         BURNRATE_API_URL: apiUrl
     };
     if (apiKey) {
         env.BURNRATE_API_KEY = apiKey;
     }
-    settings.mcpServers.burnrate = {
-        command: mcpCommand,
-        args: mcpArgs,
-        env
+    const mcpConfig = {
+        mcpServers: {
+            burnrate: {
+                type: 'stdio',
+                command: mcpCommand,
+                args: mcpArgs,
+                env
+            }
+        }
     };
-    // Ensure directory exists
-    if (!fs.existsSync(claudeSettingsDir)) {
-        fs.mkdirSync(claudeSettingsDir, { recursive: true });
-    }
-    fs.writeFileSync(claudeSettingsPath, JSON.stringify(settings, null, 2));
-    console.log(`\n✓ Claude Code MCP settings written to ${claudeSettingsPath}`);
+    fs.writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2) + '\n');
+    console.log(`\n✓ MCP config written to ${mcpConfigPath}`);
     // 7. Summary
     console.log(`
 ╔══════════════════════════════════════════════════════════════╗
 ║                     SETUP COMPLETE                           ║
 ╠══════════════════════════════════════════════════════════════╣
 ║                                                              ║
-║  Restart Claude Code to load the MCP server.                 ║
+║  Start Claude Code from this directory:                      ║
+║    claude                                                    ║
 ║                                                              ║
 ║  Then ask Claude:                                            ║
 ║    "Use burnrate_join to create a character named MyName"    ║

package/dist/mcp/server.js

@@ -1874,4 +1874,10 @@ async function main() {
     await server.connect(transport);
     console.error('BURNRATE MCP Server running');
 }
-main().catch(console.error);
+try {
+    await main();
+}
+catch (err) {
+    console.error(err);
+    process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "burnrate",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "A logistics war MMO for Claude Code. The front doesn't feed itself.",
   "type": "module",
   "main": "dist/cli/index.js",