コーディングエージェントがモバイルアプリのアニメーションを記録し、フレームドロップを分析して、ソースコードにモーションチューニングの修正を自動的に適用できるようにします。
別名 keyframer-dev/inspector, inspector, @keyframerdev/inspector
- スター
- 6
- ツール
- —
- ダウンロード数(30日間)
- 987
- 最新バージョン
- 0.4.0
- 最終コミット
- 2026年11月14日
- ライセンス
- MIT
Keyframer Inspector MCPとは
Keyframer InspectorはMCPサーバーです。 コーディングエージェントがモバイルアプリのアニメーションを記録し、フレームドロップを分析して、ソースコードにモーションチューニングの修正を自動的に適用できるようにします。.
プロジェクトの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における品質ゲート継続的インテグレーションパイプライン内で、プルリクエストの品質ゲートとしてアニメーションの録画を使用できます。
プロジェクトの 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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
エージェントはアニメーションの問題を自動的に修正できますか?
はい。checkおよびrecheckコマンドを使用することで、エージェントは測定、コード変更、再測定のループを実行し、問題が解決されるまで修正を繰り返すことができます。
データはクラウドに送信されますか?
いいえ。共有リンクを明示的に作成しない限り、録画データ、リレー、およびMCP serverはローカルのMac内に保持されます。