Ermöglicht es Coding Agents, Mobile App Animationen aufzunehmen, Frame Drops zu analysieren und automatisch Motion Tuning Fixes im Quellcode anzuwenden.
Auch bekannt als keyframer-dev/inspector, inspector, @keyframerdev/inspector
- Stars
- 6
- Tools
- —
- Downloads, 30 Tage
- 987
- Neueste Version
- 0.4.0
- Letzter Commit
- 14. Nov. 2026
- Lizenz
- MIT
Was ist Keyframer Inspector MCP?
Keyframer Inspector ist ein MCP server. Ermöglicht es Coding Agents, Mobile App Animationen aufzunehmen, Frame Drops zu analysieren und automatisch Motion Tuning Fixes im Quellcode anzuwenden.
Zusammenfassung generiert aus dem README des Projekts
Über Keyframer Inspector MCP server
Keyframer Inspector dient als Motion Debugger für Mobile App Entwickler, die mit iOS, Android, Flutter oder React Native arbeiten. Er ermöglicht es Nutzern, App-Animationen aufzunehmen und zu analysieren, warum bestimmte Frames gedroppt sind. Durch die Verbindung einer App via SDK mit der macOS Desktop App können Entwickler durch die Aufnahmen wie durch ein Video scrubben, um genau zu sehen, welche Codezeile eine Animation ausgelöst hat und wie hoch der Performance-Verlust war.
Der Server fungiert als MCP Bridge für Coding Agents wie Claude Code, Cursor oder Windsurf. Sobald er in den Desktop App Settings aktiviert ist, kann ein Agent Tools nutzen, um App-Szenarien aufzunehmen, Traces zu lesen und Screenshots zu machen. Er unterstützt speziell eine Fix-Loop über check- und recheck-Commands, bei der der Agent die Performance misst, den Quellcode modifiziert und erneut misst, bis die Frame Drops behoben sind. Alle Aufnahmen und Daten bleiben lokal auf dem Mac, außer ein Nutzer erstellt explizit einen Share Link.
Was du damit machen kannst
- 1Automated motion tuningEin AI Agent kann Animationsdauern oder Spring-Settings in deinem Quellcode automatisch anpassen, um Performance-Probleme zu beheben.
- 2Debugging frame dropsEntwickler können den spezifischen Code identifizieren, der für Animationsverzögerungen und Frame Drops verantwortlich ist.
- 3Autonomous performance fixingEin Coding Agent kann eine kontinuierliche Loop aus Messen, Code ändern und erneut Messen ausführen, um Motion-Probleme zu eliminieren.
- 4CI/CD quality gatingDu kannst Animationsaufnahmen nutzen, um Pull Requests innerhalb deiner Continuous Integration Pipeline zu prüfen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Keyframer Inspector MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenKeyframer Inspector MCP in Claude Code installieren
$ claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspectorKeyframer Inspector MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Keyframer Inspector MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"inspector": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Keyframer Inspector MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"inspector","type":"stdio","command":"npx","args":["-y","@keyframerdev/inspector"],"env":{"KEYFRAMER_VITALS_READ_KEY":"<YOUR_KEYFRAMER_VITALS_READ_KEY>"}}'Keyframer Inspector MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Keyframer Inspector MCP in Codex installieren
$ codex mcp add inspector --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' -- npx -y @keyframerdev/inspectorKeyframer Inspector MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.inspector] command = "npx" args = ["-y", "@keyframerdev/inspector"] [mcp_servers.inspector.env] KEYFRAMER_VITALS_READ_KEY = "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
Keyframer Inspector MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector npx -- -y @keyframerdev/inspectorKeyframer Inspector MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Konfiguration
KEYFRAMER_VITALS_READ_KEYSecretOptional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it.
| Name | Beschreibung | Typ |
|---|---|---|
| KEYFRAMER_VITALS_READ_KEY | Optional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it. | Secret |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertNicht geprüft
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenKeyframer Inspector
A motion debugger for apps. Every animation, with the line of code that started it, what it cost, and why frames dropped, recorded on the device and scrubbed like a video. Tune a duration or a spring and write the numbers back to your source. Hand the recording to a coding agent over MCP, or gate pull requests on it in CI.
https://github.com/user-attachments/assets/81d909d3-64fb-431b-a06f-1d20da5d5952
This repository holds the SDKs that go into your app, for every platform, under MIT.
| Platform | Folder | Install |
|---|---|---|
| React Native (Reanimated) | react-native/ |
npm i -D @keyframerdev/inspector |
| iOS (UIKit) | ios/ |
Swift Package Manager: https://github.com/keyframer-dev/inspector |
| Android (Views) | android/ |
debugImplementation("dev.keyframer:keyframer-inspector:<version>") |
| Flutter | flutter/ |
flutter pub add keyframer_inspector |
The apps connect to Keyframer Inspector, the desktop app (below). React Native apps can also use the panel inside Expo's dev tools, no desktop app needed.
Quick start
React Native. Add the Babel plugin in development (before react-native-worklets/plugin), connect,
then press shift+m in Metro and open @keyframerdev/inspector. The
npm README has the details, bare React Native
included, and react-native/example is an Expo app with it all set up.
// babel.config.js (Expo)
plugins: process.env.NODE_ENV !== 'production' ? ['@keyframerdev/inspector/babel'] : []
// your root layout
if (__DEV__) require('@keyframerdev/inspector/devtools').connectDevTools({ app: 'MyApp' })
iOS.
import KeyframerInspector
#if DEBUG
KeyframerInspector.start() // simulator: ws://127.0.0.1:8790
KeyframerInspector.start(.init(host: "192.168.1.20")) // a device: the Mac's LAN address
#endif
Android.
// Application.onCreate (debuggable builds only)
Keyframer.start(this)
ObjectAnimator.ofFloat(title, View.ALPHA, 0f, 1f).kfTrack("title").start()
Flutter.
void main() => runApp(const KeyframerInspector(app: 'My app', appPackage: 'my_app', child: MyApp()));
Each folder's README covers the API, what is reported and how, and its tests.
The desktop app
Keyframer Inspector for macOS (Apple silicon and Intel) is where every SDK connects. Download it from Releases. It is free, signed and notarized, and keeps itself up to date.
-
Every platform, one place. iOS, Android, Flutter and React Native apps connect to it on
ws://<your Mac>:8790: simulators and emulators on their own, devices on the same network with the address the status bar shows. Several apps at once, with a switcher. -
The panel. Record, then drag to scrub: the app follows, back to the screen it was on. Tracks show every animation as segments you can click to tune (duration, delay, spring) live, then apply the numbers to your source. Problems come ranked by the frames they cost, each with where it is, what was running and the fix. Compare two sessions, before and after a change. Open any step in Cursor, VS Code, Zed or Xcode.
-
An MCP server for coding agents. Built in, one switch in Settings, and nothing else to install. Claude Code, Codex, Cursor, VS Code, Windsurf, Zed and Claude Desktop can record your app, run its scenarios, read the trace and the problems, and take screenshots. With
checkandrecheckan agent runs the fix loop: measure, change the code, measure again, until the problems are gone and the motion still works. Settings shows the setup for each client; for Claude Code:claude mcp add --transport http keyframer-inspector http://127.0.0.1:8789/mcp -
A recordings library. Recordings (
.kfrec.json) from the panel, from testers' devices or from share links land in one folder. Double-click one to open it; share links open in the app. -
In the menu bar. Closing the window keeps the relay running. The menu shows the connected apps and the MCP server, with switches for the server and for launching at login.
-
Updates on its own. It checks after launch and every six hours, downloads in the background and installs when you restart or quit. Every update is signed, and the app installs nothing else.
-
Local. Recordings, the relay and the MCP server stay on your Mac. Nothing leaves it unless you make a share link.
Protocol
Every SDK speaks one wire protocol, protocol/inspector.ts: hello, the
signals an app exposes, animation events with their call sites, frames, screens, recordings, and what
an editor sends back (record, scrub, overrides, scenarios). A new platform needs only to speak it.
Issues and contributions
Issues for any platform, the desktop app and the npm package go here. This repository is published from Keyframer's own; pull requests are welcome, and land here once merged there.
License
MIT for everything in this repository (LICENSE). The desktop app is free and closed
source. In the npm package, what runs in your app is MIT (its source is react-native/), and the tools
(the CLI, the MCP server and the panel) are under the Functional Source License; see its
LICENSE.md.
Keyframer Inspector MCP Fragen
Wie füge ich Keyframer Inspector MCP zu Claude Code hinzu?
Führe claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspector in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Keyframer Inspector MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Kann der Agent Animationsprobleme automatisch beheben?
Ja, mithilfe der check- und recheck-Commands kann ein Agent eine Fix-Loop ausführen, indem er misst, den Code ändert und erneut misst, bis die Probleme gelöst sind.
Werden die Daten in die Cloud gesendet?
Nein, die Aufnahmen, der Relay und der MCP server bleiben lokal auf deinem Mac, es sei denn, du erstellst explizit einen Share Link.