fgui-agent-bridge
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FGUI_PROJECT_PATH | No | Path to the FairyGUI project (alternative to --project or fgui_use_project). | |
| FAIRYGUI_EDITOR_PATH | No | Path to the FairyGUI Editor executable (e.g., /Applications/FairyGUI-Editor.app on macOS or C:\Tools\FairyGUI-Editor\FairyGUI-Editor.exe on Windows). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| fgui_statusA | 读取本地 FairyGUI 工程选择和桥接心跳，不主动唤醒编辑器。 |
| fgui_pingA | 唤醒 FairyGUI Editor 并验证桥接协议、版本和能力。 |
| fgui_use_projectA | 为当前 MCP 会话选择 .fairy 文件、FairyGUI 工程目录或仓库目录。 |
| fgui_get_projectC | 读取当前 FairyGUI 工程信息。 |
| fgui_list_packagesA | 列出当前 FairyGUI 工程中的全部包。 |
| fgui_list_itemsA | 列出指定包中的资源，可按 FairyGUI 资源类型过滤。 |
| fgui_open_documentB | 按包名和资源名打开 FairyGUI 组件文档。 |
| fgui_create_componentA | 在指定包中新建组件文档；默认打开但不保存，重名时默认拒绝。 |
| fgui_import_imageA | 从绝对本地路径导入图片；这是磁盘写入操作，支持拒绝、自动改名或替换同名图片。 |
| fgui_create_buttonB | 创建标准 FairyGUI Button 组件；状态图顺序为 up/down/over/selectedOver/disabled/selectedDisabled。 |
| fgui_get_active_documentA | 读取当前活动文档、修改状态和选择数量。 |
| fgui_get_treeA | 读取当前组件对象树；修改前应先取得稳定的对象 ID 或路径。 |
| fgui_get_historyB | 读取 Agent 属性事务栈和 FairyGUI 原生撤销状态。 |
| fgui_select_objectB | 通过对象 ID、对象树路径或唯一名称选择一个对象。 |
| fgui_set_propertyA | 修改白名单属性但不保存；该操作进入 Agent 属性 undo/redo 事务栈。 |
| fgui_insert_objectA | 插入已有 ui:// 资源但不保存；结构操作不能由 Agent 属性事务栈撤销。 |
| fgui_remove_objectA | 删除非根对象但不保存；需要可靠回退时使用 fgui_discard_document。 |
| fgui_undoA | 优先撤销 Agent 属性事务；事务栈为空时回退到 FairyGUI 原生撤销。 |
| fgui_redoA | 优先重做 Agent 属性事务；事务栈为空时回退到 FairyGUI 原生重做。 |
| fgui_save_documentA | 显式保存当前 FairyGUI 文档，并清空 Agent 属性事务栈。 |
| fgui_save_allA | 显式保存所有 FairyGUI 文档、已打开包和工程，并清空 Agent 属性事务栈。 |
| fgui_get_publish_settingsA | 读取工程发布目录、格式、图集、代码生成和包级覆盖设置。发布前应先调用。 |
| fgui_publishA | 按工程发布设置导出 FairyGUI 包。默认发布当前文档所属包并先保存；可选择指定包或全部包。 |
| fgui_discard_documentA | 放弃当前文档全部未保存修改并重新加载磁盘版本。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 24 tools
Each tool targets a distinct operation: create/insert/remove, undo/redo, save/discard, publish, project selection, and property manipulation. Even similar tools like status and ping are differentiated by whether they wake the editor.
All tool names follow a consistent snake_case pattern with the fgui_ prefix, and the action verb typically comes first (insert_object, remove_object, save_document, get_project). No mixed conventions or unpredictable naming.
With 24 tools, the server is at the upper end of the 16-25 range, which feels heavy. However, each tool serves a distinct purpose in the FairyGUI editing workflow, so the count is borderline but not excessive.
The tool set covers core editing operations like object manipulation, property setting, undo/redo, and publishing, but lacks a delete_component operation and a direct get_property tool. This means some lifecycle operations are missing, leaving notable gaps.