Fyrox MCP Pro

首款也是唯一的 Fyrox 游戏引擎 MCP 集成方案。41 款工具,涵盖 7 大类别——场景控制、物理检测、射线投射、批量操作、属性编辑等。

Claude Code ← stdio → MCP 服务器(TypeScript)← WebSocket → 桥接插件(Rust)← 进程内 → Fyrox 编辑器 所有变更操作均通过编辑器的 Command 模式执行——支持完整的撤销/重做

什么是 Fyrox?

Fyrox 是一款可用于生产环境的 2D/3D 游戏引擎,完全使用 Rust 编写。拥有完整的可视化编辑器、35 个以上的专用 crate 和 MIT 许可证,是 Godot 和 Unity 的 Rust 原生替代方案。

🦀

100% Rust

内存安全、高性能、无垃圾回收器

🎨

可视化编辑器

功能全面的场景编辑器,可与 Godot 或 Unreal 媲美

🔊

HRTF 音频

双耳 3D 空间音频,支持混响效果

🤖

内置 AI

开箱即用的行为树和状态机

🎭

动画

混合状态机、根运动、精灵表

🧩

35+ Crate

图形、物理、UI、物品栏、对话、自动平铺、国际化

🌐

跨平台

Windows、macOS、Linux、WebAssembly、Android

📜

MIT 许可证

完全开源,无版税,无附加条件

AI 能在 Fyrox 中做什么?

🏗️ 场景构建

创建 10 种节点类型——网格体、灯光、摄像机、粒子系统、地形、精灵等。通过单次可撤销操作批量创建多个节点。

🔬 组件检测

查询刚体、碰撞体、灯光、摄像机和音频源。在物理世界中投射射线。一览场景统计信息和编辑器状态。

🔧 属性编辑

通过 Reflect 路径设置任意节点属性——名称、可见性、物理参数、灯光强度等。支持重命名、启用/禁用、复制节点和列出脚本。

🔄 完整撤销/重做

所有 AI 操作均通过编辑器的 Command 模式执行。Ctrl+Z 对所有操作有效——不会有意外,不会丢失数据。可查看命令历史堆栈。

🎮 构建与运行

直接从 Claude 启动游戏。构建、测试、停止——无需触碰鼠标即可快速迭代。

📚 Fyrox 技能库

包含全面的参考资料:引擎 API、MCP 工具指南以及常用模式(FPS 控制器、生命值系统、生成器、物理)。

批量操作

通过单次调用批量创建、变换或删除多个节点。高效场景组装——无需逐节点往返开销。

🌳 场景图控制

查询完整节点树、按名称搜索、检查属性、重新设置父节点、设置变换、获取子节点——全面的层级管理。

41 款 MCP 工具

通过 Model Context Protocol 实现 7 大类别的完整编辑器控制。

场景查询(4 款工具)

fyrox_get_scene_hierarchy 完整节点树
fyrox_get_node_properties 节点详细信息
fyrox_search_nodes 按名称查找节点
fyrox_list_scenes 列出已打开的场景

节点操作(4 款工具,可撤销)

fyrox_create_node 创建 10 种节点类型
fyrox_delete_node 删除节点及子树
fyrox_set_node_transform 位置/旋转/缩放
fyrox_link_node 重新设置父节点

属性编辑(7 款工具)

fyrox_set_node_property 通过 Reflect 路径设置任意属性
fyrox_rename_node 重命名节点
fyrox_set_node_enabled 启用/禁用可见性
fyrox_duplicate_node 复制节点
fyrox_get_children 列出直接子节点
fyrox_get_scripts 列出附加的脚本
fyrox_get_scene_statistics 按类型统计节点数

组件检测(10 款工具)

fyrox_get_rigidbody 物理刚体属性
fyrox_get_collider 碰撞体形状和材质
fyrox_raycast 在物理世界中投射射线
fyrox_get_light 灯光类型、强度、阴影
fyrox_get_camera 投影、裁剪、曝光
fyrox_get_sound 音频增益、循环、状态
fyrox_get_scene_settings 环境光照配置
fyrox_get_editor_mode 编辑/构建/播放状态
fyrox_get_command_history 撤销/重做堆栈状态
fyrox_get_editor_settings 编辑器设置概要

选择操作(3 款工具)

fyrox_get_selection 当前选择
fyrox_set_selection 设置选择
fyrox_focus_node 将摄像机聚焦到节点

项目与工作流(9 款工具)

fyrox_save_scene 保存当前场景
fyrox_save_scene_as 另存为新路径
fyrox_load_scene 加载场景文件
fyrox_new_scene 创建新场景
fyrox_undo / fyrox_redo 撤销/重做操作
fyrox_build_and_run 构建并测试运行
fyrox_stop_game 停止运行中的游戏
fyrox_ping 健康检查

批量操作(4 款工具)

fyrox_batch_create_nodes 一次性创建多个节点
fyrox_batch_set_transforms 一次性变换多个节点
fyrox_batch_delete_nodes 一次性删除多个节点
fyrox_list_methods 列出所有桥接方法

3 步完成设置

1

添加桥接插件

fyrox-mcp-bridge 添加到编辑器的 Cargo.toml 并注册:

editor.add_editor_plugin(McpBridgePlugin::new(Default::default()));

2

安装 MCP 服务器

cd fyrox-mcp-server && npm install && npm run build

3

配置 Claude Code

claude mcp add fyrox -- node /path/to/fyrox-mcp-server/dist/index.js

为什么选择 Fyrox 开发下一款游戏?

一款功能毫不妥协的现代 Rust 游戏引擎。

功能Fyrox其他 Rust 引擎
可视化编辑器完整场景编辑器(FyroxEd)有限或无
3D 音频HRTF 双耳音频基础播放
动画ABSM + 根运动 + 图层基础缓动
AI 系统行为树 + 状态机需手动实现
游戏系统物品栏、对话、自动平铺、国际化需自行构建
AI MCP 集成Fyrox MCP Pro(41 款工具)
许可证MIT各异

系统要求

Fyrox 1.0+ Rust 1.87+ Node.js 18+ Claude Code Windows macOS Linux

常见问题

什么是 Fyrox?

Fyrox 是一款可用于生产环境的 2D/3D 游戏引擎,使用 Rust 编写。它内置可视化场景编辑器,提供 35 个以上的 crate,涵盖图形、音频、动画、AI、物理、UI 等领域。可以将它理解为"Rust 版的 Godot"——具备 HRTF 空间音频、动画混合状态机、行为树和内置物品栏系统等功能。

使用 Fyrox 需要懂 Rust 吗?

具备基础的 Rust 知识会有帮助,但 Fyrox MCP Pro 可以让 AI 处理大量样板代码。Claude 可以生成 Rust 脚本、搭建场景、解释设计模式——即使您刚接触 Rust,也能轻松上手 Fyrox。

桥接插件是如何工作的?

桥接插件是一个 Rust EditorPlugin,它在 Fyrox 编辑器内启动一个 WebSocket 服务器(默认端口 17563)。MCP 服务器通过 WebSocket 连接,使用 JSON-RPC 2.0 将 Claude 的工具调用转换为编辑器命令。主编辑器线程以 60 FPS 处理请求。

支持撤销/重做吗?

完全支持。所有节点创建、删除、变换更改和层级操作都通过编辑器的 Command 模式执行。Ctrl+Z 对每一个 AI 发起的更改都有效。

可以搭配 Cursor 或其他 AI 编辑器使用吗?

可以。MCP 服务器使用标准 stdio 传输协议,因此兼容任何支持 MCP 的客户端——Claude Code、Claude Desktop、Cursor、VS Code + Cline 等。

AI 可以创建哪些节点类型?

12 种类型:基础节点(枢轴)、网格体、灯光(点光源/聚光灯/平行光)、摄像机、精灵、粒子系统、地形、声源、刚体、碰撞体、动画播放器等。

用 AI 开发 Fyrox 游戏

41 款工具。完整撤销/重做。唯一的 Fyrox MCP 集成方案。一次性付费 $5。

获取 Fyrox MCP Pro