marble-headed-mcp 0.1.42 → 0.1.44

package/README.md

@@ -1 +1,50 @@
 # marble-headed-mcp
+
+Local-first MCP development setup (no npm publish needed to test).
+
+## Config files
+
+- `mcp.local.json`: runs local build (`node dist/index.js`)
+- `mcp.prod.json`: runs published npm package (`npx marble-headed-mcp@0.1.42`)
+- `mcp.json`: active config used by your local Codex session
+
+## One-command switch for Codex + Claude
+
+Use these commands from this repo:
+
+- `npm run switch:mcp:dev`
+- `npm run switch:mcp:prod`
+- `npm run switch:mcp:status`
+
+What gets updated:
+
+- `mcp.json` in this repo
+- `~/.codex/config.toml` (`[mcp_servers.marble-headed]`)
+- `~/.claude.json` (`mcpServers.marble-headed` globally + project entries)
+
+After switching, restart active Codex and Claude sessions.
+
+## Common workflow
+
+1. Install deps once:
+   - `npm ci`
+2. Switch to local MCP mode:
+   - `npm run use:mcp:local`
+3. Build once (or use watch):
+   - `npm run build`
+   - or `npm run watch`
+4. Restart Codex session so MCP reloads from `mcp.json`.
+5. Test changes locally without publishing to npm.
+
+## Switch back to published MCP
+
+- `npm run use:mcp:prod`
+- Restart Codex session.
+
+## Publish flow (when ready)
+
+1. Keep testing locally until stable.
+2. Bump version:
+   - `npm version patch`
+3. Publish:
+   - `npm publish --access public`

package/dist/index.js

@@ -6,9 +6,10 @@ import { promisify } from 'util';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-const DEFAULT_BASE_URL = 'http://localhost:3000';
+const DEFAULT_BROWSER_APP_BASE_URL = 'http://localhost:3000';
+const DEFAULT_HEADED_SERVER_BASE_URL = 'http://localhost:4000';
 const ENVIRONMENT_BASE_URLS = {
-    localhost: 'http://localhost:3000',
+    localhost: DEFAULT_BROWSER_APP_BASE_URL,
     dev: 'https://dev.withmarble.ai',
     production: 'https://withmarble.ai',
 };
@@ -126,7 +127,7 @@ async function readCodexThreadIdFromLog(filePath) {
     }
 }
 function resolveHeadedServerRawBaseUrl() {
-    const base = process.env.HEADED_SERVER_BASE_URL || DEFAULT_BASE_URL;
+    const base = process.env.HEADED_SERVER_BASE_URL || DEFAULT_HEADED_SERVER_BASE_URL;
     return normalizeBaseUrl(base);
 }
 function resolveHeadedServerAppBaseUrl() {
@@ -431,7 +432,7 @@ async function saveImageFromUrl({ url, filename }) {
 const TOOLS = [
     {
         name: 'set_environment',
-        description: 'Set the in-browser app environment used by headed session actions. localhost -> http://localhost:3000, dev -> https://dev.withmarble.ai, production -> https://withmarble.ai. API calls still go to HEADED_SERVER_BASE_URL (default localhost:3000).',
+        description: 'Set the in-browser app environment used by headed session actions. localhost -> http://localhost:3000, dev -> https://dev.withmarble.ai, production -> https://withmarble.ai. API calls still go to HEADED_SERVER_BASE_URL (default localhost:4000).',
         inputSchema: {
             type: 'object',
             properties: {
@@ -601,7 +602,7 @@ const TOOLS = [
                 },
                 createProgram: { type: 'boolean', description: 'If true (default), auto-generate program projects before save.' },
                 createProgramMessage: { type: 'string', description: 'Optional custom message used for program generation turn.' },
-                maxOperatorTurns: { type: 'number', description: 'Max auto-follow-up turns after the initial goal (default: 4).' },
+                maxOperatorTurns: { type: 'number', description: 'Max auto-follow-up turns after the initial goal (default: 5).' },
                 workflowRunName: { type: 'string', description: 'Override workflow run name.' },
             },
             required: ['goal'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "marble-headed-mcp",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "description": "MCP server for Marble headed automation endpoints",
   "main": "dist/index.js",
   "type": "module",
@@ -16,7 +16,13 @@
     "build": "tsc",
     "prepare": "npm run build",
     "watch": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "dev:mcp": "node dist/index.js",
+    "use:mcp:local": "cp mcp.local.json mcp.json",
+    "use:mcp:prod": "cp mcp.prod.json mcp.json",
+    "switch:mcp:dev": "node scripts/switch-mcp-mode.mjs dev",
+    "switch:mcp:prod": "node scripts/switch-mcp-mode.mjs prod",
+    "switch:mcp:status": "node scripts/switch-mcp-mode.mjs status"
   },
   "keywords": [
     "mcp",