Memungkinkan coding agent untuk merekam animasi aplikasi mobile, menganalisis frame drops, dan secara otomatis menerapkan perbaikan motion tuning ke dalam source code.
Juga dikenal sebagai keyframer-dev/inspector, inspector, @keyframerdev/inspector
- Stars
- 6
- Tools
- —
- Unduhan, 30 hari
- 987
- Versi terbaru
- 0.4.0
- Commit terakhir
- 14 Nov 2026
- Lisensi
- MIT
Apa itu Keyframer Inspector MCP?
Keyframer Inspector adalah MCP server. Memungkinkan coding agent untuk merekam animasi aplikasi mobile, menganalisis frame drops, dan secara otomatis menerapkan perbaikan motion tuning ke dalam source code.
Ringkasan dibuat dari README proyek
Tentang Keyframer Inspector MCP server
Keyframer Inspector berfungsi sebagai motion debugger bagi developer aplikasi mobile yang bekerja dengan iOS, Android, Flutter, atau React Native. Tool ini memungkinkan pengguna untuk merekam animasi aplikasi dan menganalisis penyebab frame tertentu mengalami drop. Dengan menghubungkan aplikasi melalui SDK ke aplikasi desktop macOS, developer dapat melakukan scrubbing pada rekaman layaknya sebuah video untuk melihat secara tepat baris kode mana yang memicu animasi dan seberapa besar dampak performanya.
Server ini berfungsi sebagai bridge MCP untuk coding agent seperti Claude Code, Cursor, atau Windsurf. Setelah diaktifkan di pengaturan aplikasi desktop, agent dapat menggunakan tools untuk merekam skenario aplikasi, membaca trace, dan mengambil screenshot. Tool ini secara khusus mendukung fix loop menggunakan command check dan recheck, di mana agent akan mengukur performa, memodifikasi source code, dan mengukur kembali hingga frame drops teratasi. Semua rekaman dan data tetap berada secara lokal di Mac kecuali jika pengguna secara eksplisit membuat link berbagi.
Apa yang bisa Anda lakukan dengannya
- 1Automated motion tuningAI agent dapat secara otomatis menyesuaikan durasi animasi atau pengaturan spring pada source code Anda untuk memperbaiki masalah performa.
- 2Debugging frame dropsDeveloper dapat mengidentifikasi kode spesifik yang bertanggung jawab atas lag animasi dan frame drops.
- 3Autonomous performance fixingCoding agent dapat menjalankan loop berkelanjutan dari proses mengukur, mengubah kode, dan mengukur kembali untuk menghilangkan masalah motion.
- 4CI/CD quality gatingAnda dapat menggunakan rekaman animasi untuk melakukan gating pada pull request di dalam pipeline continuous integration Anda.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Keyframer Inspector MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Keyframer Inspector MCP di Claude Code
$ claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspectorInstal Keyframer Inspector MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Instal Keyframer Inspector MCP di 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>"
}
}
}
}Instal Keyframer Inspector MCP di 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>"}}'Instal Keyframer Inspector MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Instal Keyframer Inspector MCP di Codex
$ codex mcp add inspector --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' -- npx -y @keyframerdev/inspectorInstal Keyframer Inspector MCP di 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>"
Instal Keyframer Inspector MCP di Gemini CLI
$ gemini mcp add -s user -e 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector npx -- -y @keyframerdev/inspectorInstal Keyframer Inspector MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Konfigurasi
KEYFRAMER_VITALS_READ_KEYRahasiaOptional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it.
| Nama | Deskripsi | Tipe |
|---|---|---|
| KEYFRAMER_VITALS_READ_KEY | Optional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it. | Rahasia |
Pengecekan otomatis
Berjalan 13 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerLolos
- Remote endpoint menggunakan HTTPSTidak diperiksa
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaLolos
README
Lihat di 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.
Pertanyaan tentang Keyframer Inspector MCP
Bagaimana cara menambahkan Keyframer Inspector MCP ke Claude Code?
Jalankan claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspector di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Keyframer Inspector MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apakah agent bisa memperbaiki masalah animasi secara otomatis?
Ya, dengan menggunakan command check dan recheck, sebuah agent dapat menjalankan loop perbaikan dengan cara mengukur, mengubah kode, dan mengukur kembali hingga masalah terselesaikan.
Apakah datanya dikirim ke cloud?
Tidak, rekaman, relay, dan MCP server tetap berada secara lokal di Mac Anda kecuali jika Anda secara eksplisit membuat link berbagi.