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 [email protected])
• 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