# Keyframer Inspector MCP server

> Allows coding agents to record mobile app animations, analyze frame drops, and automatically apply motion tuning fixes to source code.

- Repository: https://github.com/keyframer-dev/inspector
- Page: https://hostedmcp.org/servers/keyframer-dev/inspector
- Transport: stdio
- Stars: 6
- License: MIT
- Latest version: 0.4.0

## Install

### Claude Code

```sh
claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspector
```

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

```json
{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@keyframerdev/inspector"
      ],
      "env": {
        "KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "inspector": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@keyframerdev/inspector"
      ],
      "env": {
        "KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"inspector","type":"stdio","command":"npx","args":["-y","@keyframerdev/inspector"],"env":{"KEYFRAMER_VITALS_READ_KEY":"<YOUR_KEYFRAMER_VITALS_READ_KEY>"}}'
```

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

```json
{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@keyframerdev/inspector"
      ],
      "env": {
        "KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add inspector --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' -- npx -y @keyframerdev/inspector
```

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

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

[mcp_servers.inspector.env]
KEYFRAMER_VITALS_READ_KEY = "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector npx -- -y @keyframerdev/inspector
```

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

```json
{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@keyframerdev/inspector"
      ],
      "env": {
        "KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `KEYFRAMER_VITALS_READ_KEY` | no | yes | Optional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it. |

## FAQ

### Can the agent automatically fix animation issues?

Yes, using the check and recheck commands, an agent can run a fix loop by measuring, changing code, and measuring again until problems are resolved.

### Is the data sent to the cloud?

No, recordings, the relay, and the MCP server remain local to your Mac unless you explicitly create a share link.
