# gambaran-mcp — source

The MCP server published to npm as [`gambaran-mcp`](https://www.npmjs.com/package/gambaran-mcp),
together with the rendering engine it is built on.

```bash
claude mcp add gambaran -- npx -y gambaran-mcp
```

| Path | What it is |
|---|---|
| `packages/mcp` | The MCP server. Tool reference and examples in its own README. |
| `packages/core` | The mockup engine — device catalog, layout geometry, motion, and the imperative Skia renderer. Shared with the Gambaran app. |
| `src/assets/devices` | The 26 device frames. |
| `tools/frame-renderer` | The generator that produces those frames, and their provenance `NOTICE`. |

## Build

```bash
npm install
npm run build
```

Requires Node 20 or newer. The build writes `packages/mcp/dist`, which is what
the npm package ships.

## Where development happens

This repository is exported from the Gambaran monorepo, which also holds the
app itself. The paths above are preserved exactly as they sit upstream, so the
sources here are byte-identical to the ones the published package is built
from. Issues and pull requests are welcome here.

## Licence

MIT © Aizz Tech Solutions. The device frames are original work generated by
`tools/frame-renderer`; see `tools/frame-renderer/NOTICE` for how they are
produced and why they are redistributable.