@smartmemory/compose-mcp

@smartmemory/compose-mcp

Slim MCP stdio launcher for @smartmemory/compose. Installing this package transitively pulls the full compose runtime; the compose-mcp binary spawns the embedded MCP server.

Compose is a structured AI dev pipeline that takes a goal to shipped code. Your agent writes the code, Compose makes it prove it: design decisions are gated before any code, every step has to clear its postconditions, and review runs on a different model than the one that wrote the work.

Install

npm install -g @smartmemory/compose-mcp

This installs both @smartmemory/compose-mcp and its peer @smartmemory/compose.

Run

npx -y @smartmemory/compose-mcp

The launcher resolves the embedded MCP server (@smartmemory/compose/mcp) and spawns it with stdio inheritance — suitable for direct Claude Code / MCP client wiring.

Wire into Claude Code

Add an entry to .claude/mcp.json:

{
  "mcpServers": {
    "compose": {
      "command": "npx",
      "args": ["-y", "@smartmemory/compose-mcp"]
    }
  }
}

Restart Claude Code; the typed compose tools (roadmap, changelog, artifact linking, journal, completion) become available.

Project layout requirement

The MCP tools mutate canonical compose artifacts (ROADMAP.md, CHANGELOG.md, docs/features/<code>/, docs/journal/). Run compose-mcp from inside a compose-initialized project — see the compose README for compose init.

Why a slim wrapper?

Discovery: published as io.github.smartmemory/compose-mcp on the official MCP registry. Installing the slim package keeps npx startup fast while the full runtime is fetched transitively.

License

MIT — same as the compose root.