kaohum/fairygui-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

41 stars 8 forks 품질 76 트렌드 16MIT

Repository Install

FairyGUI 편집기 자동화를위한 MCP 도구 - AI Assistant가 FairyGUI를 운영하도록하십시오

개요

MCP for FairyGUI 是一一 Model Context Protocol (MCP) 的,, AI AI (클래드 코드、Cursor ☸) Fair FairyGUI 编辑器交互。 AI、和和和件、和、和、、。 1. AI 用 MCP BASE → Python MCP Python 2. MCP MC MC bridge/commands/ 目-58 3. FairyGUI ܧ中的 Lua Proxy件 100ms 文件 4. З件行行鶏,, bridge/results/ 5. MCP MC取 Summary, AI AI - 3.10+ - (Windows 版本) - MCP MC(Claude Code / Cursor / MCP factor) - Windows (보존 Win Win32 API) 플러그인/MCPBridge/ 目/的 FairyGUI DSM目的 플러그인/ 目下: Fair,台台出现 [MCPBridge] ₪件成。 (~/.claude/settings.json m目 .mcp.json): UI PROJECT PATH TH的 FairyGUI 目目で(비밀번호/和패키지.xml 的目)。

개요(AI 번역)

** Fair Fair Fair Fair**

Korean | 한국어

₢ 킹

MCP for FairyGUI 是一一 Model Context Protocol (MCP) 的, AI AI (클래드 코드、Cursor ☸) Fair FairyGUI 编辑器交互。

AI、和和和件、和、和、、。

본부

** 정보통신부:**

AI 用 MCP BASE → 파이썬 MCP Python
MCP MC JSON bridge/commands/ 目录
FairyGUI 炉端串中的 루아 ܧ件 100ms 文件
行,T bridge/results/
MCP , AI AI AI

칫솔

理

브랜드	브랜드
`fg_list_packages`	目中中有 (名)
[T3]	炉端串取3(图片件/外/字体/文件))
【T4】
【T5】	件
【T6】	名名名
【T7】	(T)

件分님의 트윗

브랜드	브랜드
`fg_read_component`	관할권 原件原原 XML
`fg_parse_component`	ソウル (G、G、R)
`fg_validate_component`	件一(XML 格、命、名、ID 形一性)

# # # # # # # # # # #

브랜드	브랜드
[T11]	和和和件
【T12】	到口前台
[T13]	T新地目定包的
【T14】	中中中件行

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

概述

MCP for FairyGUI 是一个基于 Model Context Protocol (MCP) 的工具集，让 AI 编程助手（如 Claude Code、Cursor 等）能够直接与 FairyGUI 编辑器交互。

AI 助手可以浏览 UI 资源、打开和预览组件、截图验证、切换控制器状态、发布 UI 包——全程无需手动操作编辑器。

工作原理

┌───────────────┐   MCP (stdio)   ┌─────────────────┐   文件轮询    ┌─────────────────┐
│   AI 助手      │◄──────────────► │  Python MCP 服务 │◄───────────►│  FairyGUI 编辑器 │
│ (Claude Code) │                 │   (fastmcp)     │    JSON     │   (Lua 插件)     │
└───────────────┘                 └─────────────────┘             └─────────────────┘

通信流程：

AI 助手调用 MCP 工具 → Python MCP 服务接收请求
MCP 服务将 JSON 命令写入 bridge/commands/ 目录
FairyGUI 编辑器中的 Lua 插件每 100ms 轮询命令文件
插件在编辑器内执行命令，将结果写入 bridge/results/
MCP 服务读取结果，返回给 AI 助手

功能特性

包与资源管理

工具	说明
`fg_list_packages`	列出项目中所有 UI 包（包名、ID、资源数）
`fg_get_package_info`	获取包详情（组件/图片/字体/文件夹列表）
`fg_list_resources`	按类型过滤列出包内资源
`fg_search_component`	跨包模糊搜索组件
`fg_move_resource`	移动或重命名包内资源
`fg_delete_resource`	删除资源（自动扫描引用，支持强制删除）

组件分析

工具	说明
`fg_read_component`	读取组件原始 XML 内容
`fg_parse_component`	解析 XML 为结构化自然语言描述（含控制器、Gear、Relation、动画）
`fg_validate_component`	验证组件规范（XML 格式、属性完整性、命名规范、ID 唯一性）

编辑器交互

工具	说明
`fg_editor_status`	检查编辑器和插件连接状态
`fg_editor_activate`	激活编辑器窗口到前台
`fg_editor_reload`	刷新项目或指定包的资源
`fg_editor_open_component`	在编辑器中打开组件进行编辑
`fg_editor_save`	保存当前打开的组件
`fg_editor_close`	关闭当前组件
`fg_editor_get_selection`	获取编辑器中当前选中的元素

预览与截图

工具	说明
`fg_editor_preview`	在预览窗口中显示组件
`fg_editor_start_test`	启动 F5 预览测试（支持指定设备分辨率，如 iPhone X、iPad Pro）
`fg_editor_stop_test`	停止 F5 预览
`fg_editor_capture_preview`	截取预览运行中的截图（支持切换设备分辨率）
`fg_editor_screenshot`	截取编辑器全屏或组件画布截图

控制器操作

工具	说明
`fg_editor_list_controllers`	列出当前组件的所有控制器（含页面名称和当前选中页）
`fg_editor_switch_controller`	切换控制器页面（按索引或名称）

发布

工具	说明
`fg_editor_publish_package`	发布指定 UI 包
`fg_editor_publish_all`	发布所有 UI 包

插件管理

工具	说明
`fg_editor_reload_plugin`	热重载命令处理器（无需重启插件）
`fg_editor_reload_all_plugins`	重载所有 FairyGUI 插件

系统要求

Python 3.10+
FairyGUI 编辑器（Windows 版本）
MCP 客户端（Claude Code / Cursor / 其他支持 MCP 的工具）
Windows 操作系统（窗口截图功能依赖 Win32 API）

快速开始

1. 安装 Python MCP 服务

cd fairyGUI-MCP
pip install -e .

Windows 用户也可以双击 install.bat。

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "fairygui-tools": {
      "command": "python",
      "args": ["-m", "mcp_fairygui.server"],
      "cwd": "/path/to/fairyGUI-MCP",
      "env": {
        "UI_PROJECT_PATH": "/path/to/your/fairygui-project"
      }
    }
  }
}