SkillFoxx
Telegram

FairyGUI Agent Bridge MCP

MCP-сервер и CLI с 76 инструментами дают агенту править открытый проект FairyGUI Editor: компоненты, ресурсы, анимации, публикация

  • 79 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Инструменты записывают и удаляют компоненты, ресурсы и пакеты в вашем проекте FairyGUI и публикуют результат
  • Плагин редактора принимает команды агента и меняет файлы проекта на диске
Все причины и проверки

wilson520403/fgui-agent-bridgeАвтор:Wilson520403

Установка

Ручная установка

git clone https://github.com/Wilson520403/fgui-agent-bridge.git

Затем uv sync --frozen и uv run python scripts/sync_to_project.py --choose-project --apply.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Инструменты записывают и удаляют компоненты, ресурсы и пакеты в вашем проекте FairyGUI и публикуют результат
  • Плагин редактора принимает команды агента и меняет файлы проекта на диске

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

FairyGUI Agent Bridge связывает ИИ-ассистента с запущенным редактором FairyGUI. Python-сервис по MCP и CLI передает команды плагину редактора, который установлен в проект, и агент создает компоненты, раскладывает интерфейс, управляет ресурсами, правит анимации и публикует пакеты. Всего 76 инструментов, версия 0.8.26. Агент создает кнопки, тексты, списки и загрузчики, вставляет экземпляры ресурсов, меняет положение и стиль текста, связи, контроллеры, обновляет элементы списков пачкой, импортирует картинки, шрифты и звуки, ищет неиспользуемые и дублирующиеся ресурсы, заменяет ссылки по проекту, редактирует Transition и ключевые кадры и собирает MovieClip. Результат проверяется чтением XML после сохранения и повторным открытием. В комплекте необязательный скилл о слоях и повторном использовании компонентов.

Для кого. Разработчикам игровых интерфейсов на FairyGUI, которые собирают экраны по макетам и хотят передать рутину агенту.

Подходит, если

  • Экран надо собрать по концепт-картинке, PSD или макету, а агент должен выделить компоненты и слои
  • В списке десятки элементов, и тексты, иконки и порядок меняют за один проход
  • Нужно найти неиспользуемые и повторяющиеся ресурсы и заменить ссылки по проекту
  • Требуется собрать переходы и ключевые кадры или создать MovieClip
  • Перед выдачей хочется опубликовать активный пакет, выбранный или все пакеты

Не подходит, если

  • У вас нет запущенного FairyGUI Editor: инструменты работают только с открытым проектом
  • Вы работаете в Windows или на другой версии редактора: основная проверка шла на 6.1.4 и macOS
  • Нужны Spine, DragonBones, Loader3D или SWF: они вне поддержки
  • Требуется полное копирование групп или правка их участников: этого пока нет

Пример запроса к агенту

Прочитай текущий компонент, добавь в правый верхний угол картинку-загрузчик и собери меню из трех пунктов на основе существующей кнопки

MCP

Транспорт
stdio
Авторизация
не нужна

Переменные окружения

FGUI_PROJECT_PATH обязательная
Абсолютный путь к проекту FairyGUI, который открыт в редакторе

Ограничения

Нужны Python 3.10 или новее, `uv`, установленный FairyGUI Editor и проект с файлом `.fairy`. Плагин ставят в каждый проект скриптом `sync_to_project.py` с флагом `--apply`, без него скрипт только показывает изменения, потом проект надо открыть заново. Основная проверка шла на FairyGUI Editor 6.1.4 и macOS, Windows и прочие версии полностью не проверены. Группировка, копирование и смена слоев ограничены обычными незаблокированными объектами под корневым компонентом. Проверка сохранения в редакторе не подтверждает работу в Unity. Сопоставление макетов Lanhu и сравнение внешнего вида еще в планах.

Как отключить. Удалите папку `plugins/agent-bridge/` из проекта FairyGUI, уберите запись `fgui` из настроек MCP и добавьте `.agent/` в `.gitignore`, если еще не добавили. Репозиторий Bridge можно удалить как обычную папку.

Частые вопросы

Как установить FairyGUI Agent Bridge?

Выполните `git clone https://github.com/Wilson520403/fgui-agent-bridge.git` и `uv sync --frozen`, затем `uv run python scripts/sync_to_project.py --choose-project --apply` и откройте проект FairyGUI заново.

Как подключить MCP-клиент?

Добавьте stdio-сервер `fgui` с командой `uv run --project <путь к Bridge> fgui-agent-mcp` и переменной `FGUI_PROJECT_PATH`. После перезагрузки вызовите `fgui_status` и `fgui_ping`.

Можно ли обойтись без MCP?

Да, есть CLI: `uv run fgui-agent --project <путь> ping`, а также `status`, `project` и `packages`. MCP и CLI работают независимо, скилл необязателен.

Чем `status` отличается от `ping`?

`status` читает уже записанное сердцебиение редактора, а `ping` ждет, пока редактор действительно ответит.

Что делает скилл?

Задает правила слоев и повторного использования: сначала проверить существующие компоненты, одинаковые элементы строить от общего исходного компонента, а различия выражать экземплярами или данными.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

MCP Bridge для Cocos Creator

MCP Bridge for Cocos Creator

Плагин для Cocos Creator 2.4.x запускает локальный сервер, и агент правит сцены, префабы, ресурсы и собирает проект через MCP

MCP-серверШирокий доступ236

Расширение для Cocos Creator со встроенным MCP-сервером: агент строит интерфейс, правит сцены и делает скриншоты редактора

MCP-серверШирокий доступ394

Плагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их

ПлагинРасширенный доступ10,9 тыс.

Плагин Unity с MCP-сервером, скиллами и CLI: агент управляет сценами, ассетами, скриптами и тестами в редакторе Unity

MCP-серверШирокий доступ4,6 тыс.

Аддон и MCP-сервер для Godot: агент видит дерево сцены, ошибки и скриншоты запущенной игры и проверяет правки в редакторе

MCP-серверШирокий доступ319

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
FairyGUI Agent Bridge (эта карточка)нетне нужна79
Cocos Creator MCP Serverнетне нужна1 486MCP-плагин для Cocos Creator; здесь мост к редактору FairyGUI с 76 инструментами и CLI
AnkleBreaker Unity MCP Pluginнетне нужна257управляет редактором Unity; здесь работа с проектом интерфейсов FairyGUI

Коротко о README

README перечисляет возможности по группам работ, дает быстрый старт с подсказкой для агента и ручной установкой, показывает JSON-настройку MCP и примеры запросов. Отдельно описаны совместимость, что не поддерживается, и порядок разработки.

Бейдж для README

Исходный SKILL.md

---
name: fgui-agent-bridge
description: 当通过 MCP、CLI 或源码使用和维护独立 FGUI Agent Bridge 仓库时使用；包括连接 FairyGUI Editor、选择工程、拼装界面时的组件分层与复用、读取/修改组件文档、保存/撤销、发布资源，以及新增或变更 Bridge Action、MCP 工具、CLI 参数、协议、安全边界、同步脚本和文档。
---

# FGUI Agent Bridge

## 目标与真源

本 Skill 面向独立 `fgui-agent-bridge` 仓库。该仓库是 Bridge、MCP、CLI 和 Skill 的唯一开发真源，业务工程中的插件与 Skill 仅是同步快照。

- FairyGUI 插件源码：`plugin/main.ts`
- FairyGUI 运行文件：`plugin/main.js`；修改源码后必须重新编译并一起提交
- 插件包与最小宿主类型：`plugin/package.json`、`plugin/types/`
- Python/MCP/CLI 真源：`src/fairygui_agent/`
- 版本必须同步：`plugin/package.json`、`pyproject.toml`、`src/fairygui_agent/__init__.py`、`plugin/main.ts`、`plugin/main.js`
- 工程文档真源：`README.md`
- 当前能力参考：[references/current-capabilities.md](references/current-capabilities.md)
- 业务工程同步入口：`scripts/sync_to_project.py`

若实现、README 和 Skill 不一致，先以代码和实际桥接响应核对，再在同一个改动中修正 README 与 Skill；不要凭旧摘要猜测 Action 或参数。

## 何时使用

- 使用 `fgui_*` MCP 工具或 `fgui-agent` CLI 操作 FairyGUI 组件。
- 拼装界面、拆分子组件、选择公共组件或处理同样式的重复元素。
- 查看包、资源、活动文档、对象树、对象 ID/路径、属性或撤销状态。
- 修改组件属性、插入/删除已有 `ui://` 资源、替换 Image/Loader 资源引用、读取或修改文本样式、验证文档结构与持久化、保存、放弃、撤销或重做。
- 发布当前包、指定包或全部包，或检查发布设置。
- 检查 Bridge/插件版本一致性，或从源仓库拉取最新代码并同步到目标工程。
- 修改插件、MCP、CLI、版本、协议、白名单、队列语义、同步脚本或 README。

## 使用工作流

### 0. 检查更新与同步（按需）

- 当用户要求“检查更新”、“拉取最新 Bridge 版本”，或 `fgui_status` 返回 `versionMatch: false` / 协议不兼容提示时：
  1. 运行 `uv run python scripts/sync_to_project.py --pull --project PATH --skill-root PATH --apply`（或 `uv run fgui-agent update --pull --apply`）；
  2. 若插件更新，提醒用户在 FairyGUI Editor 中重新打开工程生效。

### 1. 连接与定位

1. 使用 `fgui_status` 查看当前会话是否已选择工程、编辑器是否在线、插件版本是否匹配以及心跳年龄；它不会唤醒编辑器。
2. 工程未选择时调用 `fgui_use_project`，参数可为 `.fairy` 文件、FairyGUI 工程目录或包含 `FairyGUI/FairyGUI.fairy` 的仓库目录。
3. 需要唤醒或验证编辑器时调用 `fgui_ping`。不要把“请求已写入队列”当作 FairyGUI 已完成。

Сообщить о проблеме