코딩 에이전트가 모바일 앱 애니메이션을 기록하고, 프레임 드롭을 분석하며, 소스 코드에 모션 튜닝 수정을 자동으로 적용할 수 있도록 지원합니다.
다른 이름 keyframer-dev/inspector, inspector, @keyframerdev/inspector
- 스타
- 6
- Tools
- —
- 다운로드, 30일
- 987
- 최신 버전
- 0.4.0
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- MIT
Keyframer Inspector MCP란?
Keyframer Inspector은(는) MCP server입니다. 코딩 에이전트가 모바일 앱 애니메이션을 기록하고, 프레임 드롭을 분석하며, 소스 코드에 모션 튜닝 수정을 자동으로 적용할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Keyframer Inspector MCP server 정보
Keyframer Inspector는 iOS, Android, Flutter 또는 React Native를 사용하는 모바일 애플리케이션 개발자를 위한 모션 디버거 역할을 합니다. 사용자는 앱 애니메이션을 기록하고 특정 프레임이 드롭되는 원인을 분석할 수 있습니다. SDK를 통해 앱을 macOS 데스크톱 애플리케이션에 연결하면, 개발자는 녹화된 영상을 탐색하며 어떤 코드 라인이 애니메이션을 트리거했는지, 그리고 그로 인한 성능 비용이 어느 정도인지 정확히 확인할 수 있습니다.
이 서버는 Claude Code, Cursor 또는 Windsurf와 같은 코딩 에이전트를 위한 MCP 브리지 역할을 합니다. 데스크톱 앱 설정에서 활성화하면 에이전트가 도구를 사용하여 앱 시나리오를 기록하고, 트레이스를 읽고, 스크린샷을 찍을 수 있습니다. 특히 check 및 recheck 명령을 사용하는 수정 루프를 지원하여, 에이전트가 성능을 측정하고 소스 코드를 수정하며 프레임 드롭이 해결될 때까지 재측정하는 과정을 수행할 수 있습니다. 사용자가 공유 링크를 명시적으로 생성하지 않는 한 모든 녹화 데이터와 정보는 Mac 로컬에 유지됩니다.
활용 사례
- 1자동 모션 튜닝AI 에이전트가 소스 코드의 애니메이션 지속 시간이나 스프링 설정을 자동으로 조정하여 성능 문제를 해결할 수 있습니다.
- 2프레임 드롭 디버깅개발자가 애니메이션 지연 및 프레임 드롭을 유발하는 특정 코드를 식별할 수 있습니다.
- 3자율 성능 수정코딩 에이전트가 측정, 코드 수정, 재측정 과정을 지속적으로 반복하여 모션 문제를 제거할 수 있습니다.
- 4CI/CD 품질 게이팅애니메이션 녹화 데이터를 사용하여 지속적 통합 파이프라인 내에서 pull request의 승인 여부를 결정하는 게이트로 사용할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Keyframer Inspector MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Keyframer Inspector MCP 설치
$ claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspectorCursor에 Keyframer Inspector MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}VS Code에 Keyframer Inspector MCP 설치
.vscode/mcp.json
{
"servers": {
"inspector": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}VS Code CLI에 Keyframer Inspector MCP 설치
$ code --add-mcp '{"name":"inspector","type":"stdio","command":"npx","args":["-y","@keyframerdev/inspector"],"env":{"KEYFRAMER_VITALS_READ_KEY":"<YOUR_KEYFRAMER_VITALS_READ_KEY>"}}'Claude Desktop에 Keyframer Inspector MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Codex에 Keyframer Inspector MCP 설치
$ codex mcp add inspector --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' -- npx -y @keyframerdev/inspectorCodex config.toml에 Keyframer Inspector MCP 설치
~/.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>"
Gemini CLI에 Keyframer Inspector MCP 설치
$ gemini mcp add -s user -e 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector npx -- -y @keyframerdev/inspectorGemini settings.json에 Keyframer Inspector MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}구성
KEYFRAMER_VITALS_READ_KEY비밀Optional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it.
| 이름 | 설명 | 유형 |
|---|---|---|
| KEYFRAMER_VITALS_READ_KEY | Optional: a Motion Vitals workspace read key (kfw_...) for field_problems and field_compare. Every other tool works without it. | 비밀 |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기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 질문
Keyframer Inspector MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspector를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Keyframer Inspector MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
에이전트가 애니메이션 문제를 자동으로 수정할 수 있나요?
네, check 및 recheck 명령을 사용하여 에이전트가 측정, 코드 수정, 재측정을 반복하는 수정 루프를 실행하여 문제가 해결될 때까지 작업을 수행할 수 있습니다.
데이터가 클라우드로 전송되나요?
아니요, 공유 링크를 명시적으로 생성하지 않는 한 녹화 데이터, 릴레이 및 MCP server는 사용자의 Mac 로컬에 유지됩니다.