Позволяет кодинг-агентам записывать анимации мобильных приложений, анализировать пропуски кадров и автоматически применять исправления параметров движения в исходном коде.
Также известен как keyframer-dev/inspector, inspector, @keyframerdev/inspector
- Звёзды
- 6
- Инструменты
- —
- Загрузки, 30 дней
- 987
- Последняя версия
- 0.4.0
- Последний коммит
- 14 нояб. 2026 г.
- Лицензия
- MIT
Что такое Keyframer Inspector MCP?
Keyframer Inspector — это MCP server. Позволяет кодинг-агентам записывать анимации мобильных приложений, анализировать пропуски кадров и автоматически применять исправления параметров движения в исходном коде.
Сводка сгенерирована из README проекта
О Keyframer Inspector MCP server
Keyframer Inspector служит отладчиком анимации для разработчиков мобильных приложений на iOS, Android, Flutter или React Native. Он позволяет записывать анимации в приложении и анализировать причины пропуска конкретных кадров. Подключив приложение к десктопному приложению macOS через SDK, разработчики могут просматривать записи, как видео, чтобы точно увидеть, какая строка кода вызвала анимацию и какую цену это заплатило в плане производительности.
Сервер функционирует как MCP bridge для кодинг-агентов, таких как Claude Code, Cursor или Windsurf. После включения в настройках десктопного приложения агент может использовать инструменты для записи сценариев приложения, чтения трассировок и создания скриншотов. Он специально поддерживает цикл исправления с помощью команд check и recheck, когда агент измеряет производительность, модифицирует исходный код и проводит повторные замеры до устранения пропусков кадров. Все записи и данные остаются локально на Mac, если пользователь явно не создаст ссылку для совместного доступа.
Что вы можете с ним делать
- 1Автоматическая настройка движенияAI агент может автоматически корректировать длительность анимации или параметры пружины (spring settings) в вашем исходном коде для исправления проблем с производительностью.
- 2Отладка пропусков кадровРазработчики могут выявлять конкретный код, ответственный за задержки анимации и пропуски кадров.
- 3Автономное исправление производительностиКодинг-агент может запускать непрерывный цикл измерения, изменения кода и повторного измерения для устранения проблем с плавностью движения.
- 4Контроль качества в CI/CDВы можете использовать записи анимаций для проверки pull requests в рамках вашего конвейера непрерывной интеграции.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Keyframer Inspector MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Keyframer Inspector MCP в Claude Code
$ claude mcp add --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector -- npx -y @keyframerdev/inspectorУстановка Keyframer Inspector MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"@keyframerdev/inspector"
],
"env": {
"KEYFRAMER_VITALS_READ_KEY": "<YOUR_KEYFRAMER_VITALS_READ_KEY>"
}
}
}
}Установка Keyframer Inspector MCP в 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>"
}
}
}
}Установка Keyframer Inspector MCP в 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>"}}'Установка Keyframer Inspector MCP в Claude Desktop
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 в Codex
$ codex mcp add inspector --env 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' -- npx -y @keyframerdev/inspectorУстановка Keyframer Inspector MCP в 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>"
Установка Keyframer Inspector MCP в Gemini CLI
$ gemini mcp add -s user -e 'KEYFRAMER_VITALS_READ_KEY=<YOUR_KEYFRAMER_VITALS_READ_KEY>' inspector npx -- -y @keyframerdev/inspectorУстановка Keyframer Inspector MCP в Gemini settings.json
~/.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. | Секрет |
Автоматические проверки
Запущено 13 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует HTTPSНе проверялось
- Деструктивные инструменты помеченыНе проверялось
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхПройдено
README
Открыть на 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.
Вопросы о 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, если вы явно не создадите ссылку для совместного доступа.