Permite que los agentes de programación graben animaciones de aplicaciones móviles, analicen la pérdida de frames y apliquen correcciones automáticas de ajuste de movimiento en el código fuente.
También conocido como keyframer-dev/inspector, inspector, @keyframerdev/inspector
- Stars
- 6
- Herramientas
- —
- Descargas, 30 días
- 987
- Última versión
- 0.4.0
- Último commit
- 14 nov 2026
- Licencia
- MIT
¿Qué es Keyframer Inspector MCP?
Keyframer Inspector es un MCP server. Permite que los agentes de programación graben animaciones de aplicaciones móviles, analicen la pérdida de frames y apliquen correcciones automáticas de ajuste de movimiento en el código fuente.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Keyframer Inspector
Keyframer Inspector funciona como un depurador de movimiento para desarrolladores de aplicaciones móviles que trabajan con iOS, Android, Flutter o React Native. Permite a los usuarios grabar animaciones de la app y analizar por qué se perdieron frames específicos. Al conectar una app mediante un SDK a la aplicación de escritorio en macOS, los desarrolladores pueden navegar por las grabaciones como si fuera un video para ver exactamente qué línea de código activó una animación y cuánto costó en términos de rendimiento.
El servidor funciona como un puente MCP para agentes de programación como Claude Code, Cursor o Windsurf. Una vez habilitado en los ajustes de la aplicación de escritorio, un agente puede usar herramientas para grabar escenarios de la app, leer trazas y tomar capturas de pantalla. Soporta específicamente un bucle de corrección mediante los comandos check y recheck, donde el agente mide el rendimiento, modifica el código fuente y vuelve a medir hasta que se resuelven las caídas de frames. Todas las grabaciones y datos permanecen locales en el Mac a menos que el usuario cree explícitamente un enlace para compartir.
Qué puedes hacer con él
- 1Ajuste de movimiento automatizadoUn agente de IA puede ajustar automáticamente las duraciones de las animaciones o los ajustes de resorte (spring settings) en tu código fuente para solucionar problemas de rendimiento.
- 2Depuración de pérdida de framesLos desarrolladores pueden identificar el código específico responsable del lag en las animaciones y la pérdida de frames.
- 3Corrección de rendimiento autónomaUn agente de programación puede ejecutar un bucle continuo de medir, cambiar código y volver a medir para eliminar problemas de movimiento.
- 4Control de calidad en CI/CDPuedes usar las grabaciones de animaciones para validar pull requests dentro de tu pipeline de integración continua.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Keyframer Inspector MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Keyframer Inspector MCP en Claude Code
$ claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspectorInstalar Keyframer Inspector MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Instalar Keyframer Inspector MCP en 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>"
}
}
}
}Instalar Keyframer Inspector MCP en 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>"}}'Instalar Keyframer Inspector MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Instalar Keyframer Inspector MCP en Codex
$ codex mcp add inspector --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' -- npx -y @keyframerdev/inspectorInstalar Keyframer Inspector MCP en 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>"
Instalar Keyframer Inspector MCP en Gemini CLI
$ gemini mcp add -s user -e 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector npx -- -y @keyframerdev/inspectorInstalar Keyframer Inspector MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Configuración
KEYFRAMER_VITALS_READ_KEYSecretoOptional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it.
| Nombre | Descripción | Tipo |
|---|---|---|
| KEYFRAMER_VITALS_READ_KEY | Optional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it. | Secreto |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasNo verificado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en 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.
Preguntas sobre Keyframer Inspector MCP
¿Cómo agrego Keyframer Inspector MCP a Claude Code?
Ejecuta claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspector en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Keyframer Inspector MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Puede el agente corregir automáticamente los problemas de animación?
Sí, mediante los comandos check y recheck, un agente puede ejecutar un bucle de corrección midiendo, cambiando el código y volviendo a medir hasta que los problemas se resuelvan.
¿Se envían los datos a la nube?
No, las grabaciones, el relay y el MCP server permanecen locales en tu Mac a menos que crees explícitamente un enlace para compartir.