burnrate 0.1.7 → 0.1.9

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/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

@@ -32,7 +32,10 @@ class GameAPIClient {
         });
         const data = await response.json();
         if (!response.ok) {
-            throw new Error(data.error || `API error: ${response.status}`);
+            const errMsg = typeof data.error === 'string'
+                ? data.error
+                : data.error?.message || `API error: ${response.status}`;
+            throw new Error(errMsg);
         }
         return data;
     }

package/dist/server/api.js

@@ -147,7 +147,8 @@ app.post('/join', async (c) => {
         message: `Welcome to BURNRATE, ${name}! Save your API key - you'll need it for all requests.`,
         apiKey: player.apiKey,
         playerId: player.id,
-        location: hub.name
+        location: hub.name,
+        nextStep: 'Ask Claude: "Use burnrate_tutorial to start the tutorial" — it will walk you through the basics and earn you credits.'
     });
 });
 // ============================================================================

package/package.json

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