# pi-motion-studio

Motion Studio MCP extension for [Pi](https://github.com/nicholasgriffintn/pi) — CSS spring animations, bounce easing, cubic-bezier visualizations, and Motion code search.

## Tools

| Tool | Description |
|------|-------------|
| `generate-css-spring` | Generate CSS spring animation easing strings |
| `generate-css-bounce-easing` | Generate CSS bounce easing strings |
| `visualise-spring` | Visualize spring animation curves (saves PNG to `/tmp/motion-studio/`) |
| `visualise-cubic-bezier` | Visualize cubic-bezier easing curves (saves PNG to `/tmp/motion-studio/`) |
| `search-motion-codex` | Search Motion code examples (react/vue/js) |

## Install

```bash
# Clone and install
git clone https://github.com/drvova/pi-motion-studio.git
cd pi-motion-studio
npm install
```

## Pi Configuration

Add to `~/.pi/agent/mcp.json`:

```json
{
  "mcpServers": {
    "motion": {
      "command": "node",
      "args": ["/path/to/pi-motion-studio/mcp/es/index.mjs"],
      "disabled": false
    }
  }
}
```

## Features

- **No auth required** — token checks patched out for local use
- **Auto-cleanup** — PNG files older than 1 hour cleaned on server start
- **Lifecycle management** — graceful shutdown on SIGTERM/SIGINT
- **All 5 tools** — including Plus-gated visualise and codex tools

## License

MIT