Permet aux agents de codage d'enregistrer les animations d'applications mobiles, d'analyser les pertes de frames et d'appliquer automatiquement des correctifs de réglage de mouvement au code source.
Aussi connu sous keyframer-dev/inspector, inspector, @keyframerdev/inspector
- Étoiles
- 6
- Outils
- —
- Téléchargements, 30 jours
- 987
- Dernière version
- 0.4.0
- Dernier commit
- 14 nov. 2026
- Licence
- MIT
Qu'est-ce que Keyframer Inspector MCP ?
Keyframer Inspector est un serveur MCP. Permet aux agents de codage d'enregistrer les animations d'applications mobiles, d'analyser les pertes de frames et d'appliquer automatiquement des correctifs de réglage de mouvement au code source.
Résumé généré à partir du README du projet
À propos du MCP server Keyframer Inspector
Keyframer Inspector sert de debugger de mouvement pour les développeurs d'applications mobiles travaillant avec iOS, Android, Flutter ou React Native. Il permet aux utilisateurs d'enregistrer les animations d'une application et d'analyser les raisons pour lesquelles certaines frames ont été perdues. En connectant une application via un SDK à l'application de bureau macOS, les développeurs peuvent parcourir les enregistrements comme une vidéo pour voir exactement quelle ligne de code a déclenché une animation et quel a été son impact sur les performances.
Le serveur fonctionne comme un pont MCP pour les agents de codage tels que Claude Code, Cursor ou Windsurf. Une fois activé dans les paramètres de l'application de bureau, un agent peut utiliser des outils pour enregistrer des scénarios d'application, lire des traces et prendre des captures d'écran. Il prend spécifiquement en charge une boucle de correction via les commandes check et recheck, où l'agent mesure les performances, modifie le code source et mesure à nouveau jusqu'à ce que les pertes de frames soient résolues. Tous les enregistrements et données restent locaux sur le Mac, sauf si l'utilisateur crée explicitement un lien de partage.
Ce que vous pouvez faire avec
- 1Réglage automatique du mouvementUn agent IA peut ajuster automatiquement les durées d'animation ou les paramètres de ressort (spring settings) dans votre code source pour corriger les problèmes de performance.
- 2Débogage des pertes de framesLes développeurs peuvent identifier le code spécifique responsable des saccades d'animation et des pertes de frames.
- 3Correction autonome des performancesUn agent de codage peut exécuter une boucle continue de mesure, de modification de code et de nouvelle mesure pour éliminer les problèmes de mouvement.
- 4Contrôle qualité CI/CDVous pouvez utiliser les enregistrements d'animation pour valider les pull requests au sein de votre pipeline d'intégration continue.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Keyframer Inspector MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Keyframer Inspector MCP dans Claude Code
$ claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspectorInstaller Keyframer Inspector MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Installer Keyframer Inspector MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"inspector": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Installer Keyframer Inspector MCP dans VS Code CLI
$ code --add-mcp '{"name":"inspector","type":"stdio","command":"npx","args":["-y","@keyframerdev/inspector"],"env":{"KEYFRAMER_VITALS_READ_KEY":"<YOUR_KEYFRAMER_VITALS_READ_KEY>"}}'Installer Keyframer Inspector MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Installer Keyframer Inspector MCP dans Codex
$ codex mcp add inspector --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' -- npx -y @keyframerdev/inspectorInstaller Keyframer Inspector MCP dans Codex config.toml
~/.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>"
Installer Keyframer Inspector MCP dans Gemini CLI
$ gemini mcp add -s user -e 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector npx -- -y @keyframerdev/inspectorInstaller Keyframer Inspector MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Configuration
KEYFRAMER_VITALS_READ_KEYSecretOptional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it.
| Nom | Description | Type |
|---|---|---|
| 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 |
Vérifications automatisées
Exécuté le 13 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSNon vérifié
- Les outils destructifs sont étiquetésNon vérifié
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur GitHubKeyframer 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.
Questions sur Keyframer Inspector MCP
Comment ajouter Keyframer Inspector MCP à Claude Code ?
Exécutez claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspector dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Keyframer Inspector MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
L'agent peut-il corriger automatiquement les problèmes d'animation ?
Oui, en utilisant les commandes check et recheck, un agent peut exécuter une boucle de correction en mesurant, en modifiant le code, puis en mesurant à nouveau jusqu'à ce que les problèmes soient résolus.
Les données sont-elles envoyées dans le cloud ?
Non, les enregistrements, le relais et le MCP server restent locaux sur votre Mac, à moins que vous ne créiez explicitement un lien de partage.