# cmpose MCP server

> Generates buildable Compose Multiplatform apps, Unity mobile games and Ktor backends locally from tested templates.

- Repository: https://github.com/whinstudio/cmpose
- Page: https://hostedmcp.org/servers/whinstudio/cmpose
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 3.0.3

## Install

### Claude Code

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

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "cmpose": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cmpose/mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"cmpose","type":"stdio","command":"npx","args":["-y","@cmpose/mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add cmpose -- npx -y @cmpose/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.cmpose]
command = "npx"
args = ["-y", "@cmpose/mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user cmpose npx -- -y @cmpose/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Tools (6)

- `cmp_describe`: Describe the cmpose generator: template types, featuresConfig flags and defaults, dependency rules, validation limits and the pinned template.
- `cmp_generate`: Generate a Compose Multiplatform (Android + iOS) project on this machine. Call cmp_describe first for the options, defaults and validation rules. Writes <outputDir>/<projectName>; never overwrites an existing non-empty folder.
- `game_describe`: Describe the Unity game generator: engine and editor version, template types, renders, flags and their dependencies, ID groups, defaults, validation limits, the pinned game template and its theme families (themes: default, and each family's id, title, suits and fontPairs).
- `game_generate`: Generate a Unity 6 (Android + iOS) mobile game project on this machine. Call game_describe first for the flags, defaults and validation rules. showcase has every flag on; flags and features apply to blank only. theme picks one of the style families game_describe lists under themes (palette, shapes, motion, fonts; match the family whose suits fits the game) and optionally a fontPair of that family. primary and accent (#RRGGBB) recolour the family: their lightness is shifted until text and buttons keep their contrast, and a colour that still cannot pass falls back to the family default with a warning. Without theme the template default family (clean) is used. Writes <outputDir>/<projectName>; never overwrites an existing non-empty folder.
- `backend_describe`: Describe the Kotlin/Ktor backend generator: options, appName rules, the project anatomy, the pinned backend template and the conventions to follow when writing code in a generated backend.
- `backend_generate`: Generate a standalone Kotlin/Ktor backend (Docker-ready) on this machine. Call backend_describe first. Writes <outputDir>/<projectName>; never overwrites an existing non-empty folder.

## FAQ

### What can cmpose generate for me?

It creates Compose Multiplatform Android and iOS app projects, Unity mobile games for Android and iOS, and standalone Kotlin/Ktor backends, all generated locally from pinned templates.

### Does cmpose require an account or API key?

No. The server runs on your machine with no account, no API key and no upload.

### Which MCP tools does the cmpose server expose?

It exposes six tools: cmp_describe, cmp_generate, game_describe, game_generate, backend_describe and backend_generate. Agents are meant to call the describe tool first.

### How do I install cmpose in Claude Code or other MCP clients?

Add it as a stdio server running npx -y @cmpose/mcp, either via the claude mcp add command or an mcpServers config entry. It requires Node.js 20+ and git.

### Does cmpose overwrite existing folders?

No. The generate tools never overwrite a non-empty folder.
