Generates buildable Compose Multiplatform apps, Unity mobile games and Ktor backends locally from tested templates.
Also known as whinstudio/cmpose, @cmpose/mcp
- Stars
- 0
- Tools
- 6
- Downloads, 30 days
- 8,882
- Latest version
- 3.0.3
- Last commit
- Nov 13, 2026
- License
- MIT
What is cmpose MCP?
cmpose generates buildable Compose Multiplatform apps, Unity mobile games and Ktor backends locally from tested templates. It exposes 6 tools, such as cmp_describe, cmp_generate, game_describe.
Summary generated from the project's README
About cmpose MCP server
Generating a buildable Compose Multiplatform Android and iOS project straight from an AI client is what cmpose does, alongside standalone Kotlin/Ktor backends and Unity 6 mobile games. It suits developers who want a real project on disk rather than sample snippets, and it runs as a local stdio server with no account, API key or upload.
You install it through npx (Node.js 20+ and git are required) and register it with Claude Code, Claude Desktop, Cursor, Windsurf or VS Code as a stdio server. Six tools cover the three generators: cmp_describe and cmp_generate for Compose apps, game_describe and game_generate for Unity, backend_describe and backend_generate for servers. Each describe tool returns defaults, option rules and limits, and agents are meant to call it first. Generated apps include androidApp, iosApp with an Xcode project, a shared module with Koin, Navigation, Kermit, Coil, in-app review and update check, a build-logic setup and a README checklist; blank templates accept options such as Ktor networking, Room, RevenueCat, AdMob and Firebase insights, plus up to three feature modules and an optional GitHub Actions workflow.
Generation happens locally from pinned template tags cached under a configurable directory, so a given version of the package always produces the same project. It never overwrites a non-empty folder, and Unity is not executed during generation.
What you can do with it
- 1Scaffold a themed habit trackerAsk the client to create a Compose Multiplatform app named Habits with a Room database, light/dark theming and AdMob ads in a chosen output folder.
- 2Start a Unity runner with adsHave the agent generate a 2D Unity game project for Android and iOS with AdMob and leaderboards enabled.
- 3Stand up a Ktor backendRequest a Kotlin Ktor server with PostgreSQL, Firebase token verification and sharing spaces so a notes API can be built on it.
- 4Check options before generatingHave the agent call the describe tool first so it knows which flags depend on others and what name formats and limits apply.
- 5Recolour a game themePick a game style family and supply primary and accent colours so the palette is adjusted while button and text contrast is kept.
Written from the project's README. Every use case is checked against a quote from it.
How to install cmpose MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall cmpose MCP in Claude Code
$ claude mcp add cmpose -- npx -y @cmpose/mcpInstall cmpose MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cmpose": {
"command": "npx",
"args": [
"-y",
"@cmpose/mcp"
]
}
}
}Install cmpose MCP in VS Code
.vscode/mcp.json
{
"servers": {
"cmpose": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cmpose/mcp"
]
}
}
}Install cmpose MCP in VS Code CLI
$ code --add-mcp '{"name":"cmpose","type":"stdio","command":"npx","args":["-y","@cmpose/mcp"]}'Install cmpose MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"cmpose": {
"command": "npx",
"args": [
"-y",
"@cmpose/mcp"
]
}
}
}Install cmpose MCP in Codex
$ codex mcp add cmpose -- npx -y @cmpose/mcpInstall cmpose MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.cmpose] command = "npx" args = ["-y", "@cmpose/mcp"]
Install cmpose MCP in Gemini CLI
$ gemini mcp add -s user cmpose npx -- -y @cmpose/mcpInstall cmpose MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cmpose": {
"command": "npx",
"args": [
"-y",
"@cmpose/mcp"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @cmpose/mcp 3.0.3 in an isolated container with no network and no keys. It answered and listed 6 tools.
cmpose MCP tools 6
Read from the server with tools/listcmp_describeDescribe the cmpose generator: template types, featuresConfig flags and defaults, dependency rules, validation limits and the pinned template.
cmp_generateGenerate 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_describeDescribe 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_generateGenerate 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_describeDescribe 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_generateGenerate a standalone Kotlin/Ktor backend (Docker-ready) on this machine. Call backend_describe first. Writes <outputDir>/<projectName>; never overwrites an existing non-empty folder.
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablewhinstudio/cmpose is public and reachablegithub.com/whinstudio/cmpose ↗Pass
- Package names this repository as its source@cmpose/mcp names whinstudio/cmpose as sourcenpmjs.com/package/@cmpose/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/whinstudio/cmpose ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @cmpose/mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@cmpose/mcp
Ask your AI agent for a Compose Multiplatform app and get a real, buildable Android + iOS
project on disk, generated locally from a tested template. It also generates Unity mobile
games (Android + iOS) and standalone Kotlin/Ktor backends. This is a local stdio MCP
server with six tools: cmp_describe, cmp_generate, game_describe, game_generate,
backend_describe and backend_generate. It runs on your machine, with no account, no API key
and no upload.
"Create a blank Compose Multiplatform app called Habits, package com.acme.habits, in ~/Projects, with Room, light/dark theming and AdMob ads."
Developer guide for generated projects: https://whinstudio.github.io/cmpose/guide.html
Install
Requires Node.js 20+ and git.
Claude Code
claude mcp add -s user cmpose -- npx -y @cmpose/mcp
Claude Desktop, Cursor, Windsurf and other MCP clients (mcpServers config):
{
"mcpServers": {
"cmpose": { "command": "npx", "args": ["-y", "@cmpose/mcp"] }
}
}
VS Code (.vscode/mcp.json):
{
"servers": {
"cmpose": { "type": "stdio", "command": "npx", "args": ["-y", "@cmpose/mcp"] }
}
}
What you get
Every project has androidApp, iosApp (Xcode project), a shared module with Koin and
Navigation, logging (Kermit), image loading (Coil), in-app review, update check, an About
screen, a build-logic with convention plugins, and a README with a release checklist.
- Template:
showcase(home, onboarding and paywall demo screens) orblank(a start screen that lists your modules and a demo of each option you pick). - Options for
blank: Ktor networking (with an optional in-app network inspector), theming (light/dark/system), multi-language strings, DataStore, Room (KMP, bundled SQLite), RevenueCat purchases with a custom Compose paywall, AdMob ads with UMP/ATT consent, detekt, backend (Ktor server, Firebase sign-in, sharing; blank only; turns on multi-language and networking), insights (Firebase Crashlytics + Analytics; off until you add the Firebase config files). - Your own feature modules: up to 3, each with contract/data/domain/presentation layers.
- CI: an optional GitHub Actions workflow.
- Your names everywhere: package, bundle id, app name, min SDK and iOS deployment target.
Games (Unity)
"Create a 2D Unity game called SkyHopper, package com.acme.skyhopper, in ~/Projects, blank, with ads and leaderboards"
Every game project is a Unity 6 project (editor 6000.3.25f1, URP) for Android and iOS, with VContainer + UniTask, a uGUI interface, a Boot → Menu → Game scene flow, a settings screen, saving, deep links, and in-app review and update check.
- Template:
showcase(a sample game with every flag on: a 2D runner, or a 3D track withrender: "3d") orblank(an empty game with the flags you pick).renderis2d(default) or3d. - Flags for
blank:saveSystem,multiLang,network,networkInspector(needsnetwork, added for you),purchases(RevenueCat),ads(AdMob),leaderboards(Google Play Games and Game Center) andinsights(Firebase Crashlytics + Analytics; off until you addgoogle-services.jsonandGoogleService-Info.plisttoAssets/Firebase, reported as a warning). - Your own feature modules (
blank): up to 3. - IDs:
idstakes your real AdMob (admob), RevenueCat (revenueCat) and Play Games + Game Center (gameServices) IDs, each group with its flag;game_describelists the fields. A group you leave out keeps the test IDs / placeholders and is reported as a warning. - Look (
theme): one of the template's style families (bright,neon,pastel,bold,nature,clean; palette, shapes, motion and a font pair), listed bygame_describeunderthemeswith what each suits.theme: { family, primary, accent, fontPair }, every field optional:primaryandaccent(#RRGGBB) recolour the family with their lightness shifted until text and buttons keep their contrast; a colour that still cannot pass keeps the family's and is reported as a warning. Withoutthemethe project getsclean, exactly as the template ships it. - Your names everywhere: package (application identifier), company name, app name, min SDK (25 to 36) and iOS deployment target (15.0 to 26.2).
"Create a backend called NotesBackend, service name notes-api, package com.acme.notes, in ~/Projects, with sharing"
Every backend is a Kotlin (JVM 21) Ktor server with PostgreSQL (Exposed, Flyway), Firebase ID
tokens verified on the server (no Admin SDK), file uploads, account deletion, one sample feature
to copy, a security checklist, a local runner (./gradlew runLocal) and the parts to deploy it
as one Docker container behind nginx. sharing adds spaces, roles and invitations.
Tools
cmp_describe: the defaults, the options and the rules (name formats, limits, which option needs which). Agents call it first.cmp_generate: creates the project. Required:projectName(letters only, up to 30),appName(up to 30 characters),packageName(e.g.com.acme.habits, up to 50 characters) and an absoluteoutputDir. Optional:templateType,features(module names up to 20),featuresConfig,minSdk(24 to 36),iosVersion(15.0 to 26.2),ci,templateRef,backendTemplateRef(the backend template tag thatserver/comes from; blank with the backend only). It returns the project path, the template version it used, warnings (e.g. test ad IDs to replace) and next steps.game_describe: the Unity game generator's engine and editor version, template types, renders, flags and their dependencies, ID groups, defaults, limits and the pinned template's theme families (themes:defaultand each family'sid,title,suitsandfontPairs; the first call downloads the template). Agents call it first.game_generate: creates the game. Required:projectName(1 to 30 letters or digits, starting with a letter),appName(up to 30 characters),packageName(e.g.com.acme.skyhopper, at least 3 segments, up to 50 characters) and an absoluteoutputDir. Optional:companyName(likeprojectName; by default the package's second segment, capitalized),templateType,render,flags,features(module names: 1 to 20 lowercase letters or digits, starting with a letter),minSdk(25 to 36),iosVersion(15.0 to 26.2, written asmajor.minor),ids,theme,templateRef. It never overwrites a non-empty folder. The result names the applied theme (theme) and lists colour fallbacks among the warnings.backend_describe: the backend generator's options,appNamerules, the project anatomy and the conventions to follow when adding code (protected routes, the 404 rule, where features go, the security checklist, the quotas, the local runner and the deploy parts). Agents call it first.backend_generate: creates the backend. Required:projectName(letters only, up to 30),appName(the service name: 2 to 31 lowercase letters, digits or-, starting with a letter; notapi,health,adminorstatic),packageName(e.g.com.acme.notes) and an absoluteoutputDir. Optional:sharing(defaultfalse),sample(the sample items feature, defaulttrue),templateRef. It never overwrites a non-empty folder.CMPOSE_BACKEND_TEMPLATE_DIR(the absolute path of a backend template checkout) generates from that checkout instead of the pinned tag.
How it works
Generation runs entirely on your machine. The first call downloads the pinned template
(whinstudio/cmpose-template) into
$XDG_CACHE_HOME/cmpose (else ~/.cache/cmpose; override with CMPOSE_CACHE_DIR), and later
calls reuse it. Games come the
same way from the pinned game template
(whinstudio/cmpose-game-template); Unity
never runs during generation. Backends come from the pinned backend template
(whinstudio/cmpose-backend-template). Each release pins one tag of each template, so @cmpose/mcp@x.y.z
always generates the same project.
Source and issues: github.com/whinstudio/cmpose. MIT licensed. The projects you generate are yours.
cmpose MCP questions
How do I add cmpose MCP to Claude Code?
Run claude mcp add cmpose -- npx -y @cmpose/mcp in your terminal. Add --scope user to make it available in every project.
How do I add cmpose MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does cmpose MCP provide?
It exposes 6 tools, including cmp_describe, cmp_generate, game_describe, game_generate, backend_describe.
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.