Kodlama ajanlarının mobil uygulama animasyonlarını kaydetmesine, kare düşmelerini (frame drops) analiz etmesine ve kaynak koda otomatik olarak hareket iyileştirme düzeltmeleri uygulamasına olanak tanır.
Ayrıca bilinen adı keyframer-dev/inspector, inspector, @keyframerdev/inspector
- Yıldızlar
- 6
- Araçlar
- —
- İndirmeler, 30 gün
- 987
- En son sürüm
- 0.4.0
- Son commit
- 14 Kas 2026
- Lisans
- MIT
Keyframer Inspector MCP nedir?
Keyframer Inspector bir MCP sunucusudur. Kodlama ajanlarının mobil uygulama animasyonlarını kaydetmesine, kare düşmelerini (frame drops) analiz etmesine ve kaynak koda otomatik olarak hareket iyileştirme düzeltmeleri uygulamasına olanak tanır.
Özet, projenin README dosyasından oluşturuldu
Keyframer Inspector MCP sunucusu hakkında
Keyframer Inspector; iOS, Android, Flutter veya React Native ile çalışan mobil uygulama geliştiricileri için bir hareket hata ayıklayıcı (motion debugger) görevi görür. Kullanıcıların uygulama animasyonlarını kaydetmesine ve belirli karelerin neden düştüğünü analiz etmesine olanak tanır. Bir uygulamayı SDK aracılığıyla macOS masaüstü uygulamasına bağlayan geliştiriciler, kayıtlar arasında bir video gibi ileri geri giderek hangi kod satırının bir animasyonu tetiklediğini ve bunun performansa ne kadar maliyet getirdiğini tam olarak görebilirler.
Server; Claude Code, Cursor veya Windsurf gibi kodlama ajanları için bir MCP köprüsü işlevi görür. Masaüstü uygulaması ayarlarından etkinleştirildiğinde, bir ajan uygulama senaryolarını kaydetmek, izleri (traces) okumak ve ekran görüntüsü almak için araçları kullanabilir. Özellikle check ve recheck komutlarını kullanarak bir düzeltme döngüsünü destekler; bu döngüde ajan performansı ölçer, kaynak kodu değiştirir ve kare düşmeleri çözülene kadar tekrar ölçüm yapar. Siz açıkça bir paylaşım bağlantısı oluşturmadığınız sürece tüm kayıtlar ve veriler Mac cihazınızda yerel olarak kalır.
Neler yapabilirsiniz
- 1Otomatik hareket iyileştirmeBir yapay zeka ajanı, performans sorunlarını gidermek için kaynak kodunuzdaki animasyon sürelerini veya yay (spring) ayarlarını otomatik olarak ayarlayabilir.
- 2Kare düşmelerini hata ayıklamaGeliştiriciler, animasyon gecikmesine ve kare düşmelerine neden olan spesifik kodu tespit edebilirler.
- 3Otonom performans düzeltmeBir kodlama ajanı, hareket sorunlarını ortadan kaldırmak için sürekli bir ölçme, kodu değiştirme ve yeniden ölçme döngüsü çalıştırabilir.
- 4CI/CD kalite kontrolüSürekli entegrasyon hattınızdaki (CI pipeline) pull request'leri denetlemek için animasyon kayıtlarını kullanabilirsiniz.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Keyframer Inspector MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleKeyframer Inspector MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspectorKeyframer Inspector MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Keyframer Inspector MCP'yi VS Code içine yükleyin
.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'yi VS Code CLI içine yükleyin
$ 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'yi Claude Desktop içine yükleyin
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'yi Codex içine yükleyin
$ codex mcp add inspector --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' -- npx -y @keyframerdev/inspectorKeyframer Inspector MCP'yi Codex config.toml içine yükleyin
~/.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'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector npx -- -y @keyframerdev/inspectorKeyframer Inspector MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Yapılandırma
KEYFRAMER_VITALS_READ_KEYGizliOptional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it.
| Ad | Açıklama | Sunucu |
|---|---|---|
| KEYFRAMER_VITALS_READ_KEY | Optional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it. | Gizli |
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
Keyframer 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 soruları
Keyframer Inspector MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspector komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Keyframer Inspector MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Ajan animasyon sorunlarını otomatik olarak düzeltebilir mi?
Evet, check ve recheck komutlarını kullanarak bir ajan; ölçüm yapma, kodu değiştirme ve sorunlar çözülene kadar tekrar ölçüm yapma şeklinde bir düzeltme döngüsü çalıştırabilir.
Veriler buluta gönderiliyor mu?
Hayır, siz açıkça bir paylaşım bağlantısı oluşturmadığınız sürece kayıtlar, relay ve MCP server Mac cihazınızda yerel olarak kalır.