bootstrap-mcp (jazz-bootstrap)

An MCP server that kills the cold-start "adjustment period" for a fresh Claude Code running inside the jazz dev-shell sandbox. Just connecting orients the agent — the server's instructions land in the client's system prompt — and the tools verify the environment and point at the shared brain (notes_db).

Tools

- orient() — layout + conventions (local-first forge, jazz-push, soft-cap, permissions-first) + how to recall state. - status() — container?, tools present (docker/git/qemu/mksquashfs/jazz-push), notes_db reachability (tries host.docker.internal:8001), forge state (action count, registry/remotes/backups counts). - memory() — the host auto-memory MEMORY.md if the memory dir is mounted into the sandbox. - checklist() — ordered onboarding steps.

Wire it into the sandbox's Claude Code

Add to the sandbox ~/.claude.json (or project .mcp.json):

{
  "mcpServers": {
    "jazz-bootstrap": {
      "command": "python",
      "args": ["-m", "bootstrap_mcp"],
      "env": {
        "FORGE_HOME": "/work/forge",
        "NOTES_DB_URL": "http://host.docker.internal:8001",
        "JAZZ_MEMORY_DIR": "/work/memory"
      }
    }
  }
}

Then a fresh agent's first move is orient() → status() → recall build-v4/doc-v4.

Config via env: FORGE_HOME, NOTES_DB_URL, JAZZ_MEMORY_DIR.