cmpose MCP server

cmpose

Generate Compose Multiplatform projects on your own machine — from any AI agent, through MCP.

Ask your agent for an app ("a blank Compose Multiplatform app called Habits with Room and theming") and get a buildable Android + iOS project from a tested template: Koin, Navigation, Ktor, Room, DataStore, theming, multi-language, RevenueCat purchases, AdMob ads, detekt and CI as options. What each option adds: packages/mcp/README.md.

• @cmpose/core — the generator library (the same code cmpose.dev runs).
• @cmpose/mcp — a local stdio MCP server with two tools: cmpdescribe and cmpgenerate.

Requires Node.js 20+ and git. The first generation downloads the pinned template (Keremturker/cmpose-template) into ~/.cache/cmpose (override: CMPOSECACHEDIR).

Use with Claude Code

claude mcp add cmpose -- npx -y @cmpose/mcp

Use with other MCP clients

Add the server to the client's mcpServers configuration:

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

cmpgenerate takes projectName, appName, packageName and an absolute outputDir (required), plus optional templateType (showcase | blank), features, featuresConfig (blank only), minSdk, iosVersion, ci and templateRef; cmpdescribe lists the defaults and rules.

Develop

npm install npm test npm run scan # public hygiene scan: private paths, names, addresses, secrets

The 5 real-template tests in packages/core/test/fileService.importSort.test.js run only when CMPREALTEMPLATEDIR points to a checkout of the template, e.g. CMPREALTEMPLATEDIR=/path/to/template-checkout npm test; otherwise they are skipped.