ue-angelscript-mcp
MCP服务器 虚幻引擎天使脚本 发展。提供文档查找、脚本文件管理和测试运行 克劳德代码 或任何MCP兼容客户端。
为 UE-AS发动机叉 Hazelight工作室。
工具
| 工具 | 描述 | 需要 |
|---|---|---|
as_get_context | 按类别或关键字查询AS文档 | 无 |
as_list_scripts | 列表 .as 项目脚本目录中的文件 | 项目路径 |
as_read_script | 读取具有可选行范围 | 项目路径的脚本文件 |
as_search_scripts | 正则表达式搜索全部 .as 文件 | 项目路径 |
as_find_cpp_binding | Angelscript绑定的Grep引擎C++源代码（例如。 METHOD, FUNC) | 发动机路径 |
as_check_script_errors | 检查最新虚幻引擎日志中的脚本编译错误 | 项目路径 |
as_scaffold | 为AS类（Actor、Widget等）生成惯用的样板 | 无 |
as_scan_definitions | 解析AST定义（类、结构、函数）的脚本文件 | 项目路径 |
as_find_usages | 搜索全部 .as 标识符使用文件 | 项目路径 |
as_run_tests | 通过commandlet运行Angelscript单元测试 | 项目路径+编辑器二进制文件 |
as_build_engine | 触发UnrealBuildTool编译项目或引擎 | 引擎路径 |
as_task_status | 检查正在运行的后台任务的状态 | 无 |
as_task_list | 列出所有后台任务 | 无 |
as_editor_status | Ping Python编辑器桥 | 编辑器桥 |
as_get_level_actors | 获取当前级别的所有演员 | 编辑桥 |
as_execute_python | 在编辑器 | 编辑器桥中执行任意Python代码 |
as_execute_snippet | 在编辑器 | 编辑器桥中编译并执行Angelscript的一段代码 |
as_spawn_actor | 从某个位置的类路径中生成一个actor | Editor Bridge |
as_focus_viewport | 将编辑器相机聚焦在演员或位置 | 编辑器桥 |
as_get_script_roots | 列出脚本根目录 | 无（用编辑器增强） |
as_project_info | 项目概述及配置状态 | 无 |
安装
git clone https://github.com/azereki/ue-angelscript-mcp.git
cd ue-angelscript-mcp
npm install
npm linknpm install 通过自动构建 prepare 脚本。
配置
添加到您的项目 .mcp.json:
{
"mcpServers": {
"ue-angelscript": {
"command": "ue-angelscript-mcp"
}
}
}就是这样。服务器会自动从工作目录中检测您的项目。
自动检测
服务器从以下位置向上移动 cwd 查找您的项目：
- 游戏项目 --目录包含
.uproject文件 - 发动机源树 --目录包含
Engine/Plugins/Angelscript/
一旦找到项目根，编辑器二进制文件将自动位于 Engine/Binaries/{platform}/UnrealEditor-Cmd.
环境变量覆盖
对于非标准布局，请在 .mcp.json env block或你的shell：
| 变量 | 描述 |
|---|---|
UE_AS_PROJECT_PATH | UE项目根路径 |
UE_AS_EDITOR_CMD | 通往 UnrealEditor-Cmd 二进制 |
UE_AS_EXTRA_SCRIPT_ROOTS | 其他脚本目录（以分号分隔） |
覆盖示例：
{
"mcpServers": {
"ue-angelscript": {
"command": "ue-angelscript-mcp",
"env": {
"UE_AS_PROJECT_PATH": "/path/to/my/project",
"UE_AS_EXTRA_SCRIPT_ROOTS": "/shared/scripts;/mods/scripts"
}
}
}
}文件类别
as_get_context 将2700多行捆绑的参考文档组织到可搜索的类别中：
| 类别 | 封面 |
|---|---|
scripting_basics | 演员、组件、UCLASS、UFUNCTION、初学者 |
language_fundamentals | 类型、容器、手柄、铸件、兰姆达斯 |
properties_events | UPROPERTY说明符、代理、计时器、输入 |
networking | 复制、RPC、网络角色、权限 |
testing | 单元测试、集成测试、潜在命令 |
bindings | C++绑定、FUNC/METHOD宏、ScriptFixin |
advanced_features | 热重载、预处理器、GAS、子系统 |
无参数调用以查看所有类别。使用 category 用于浏览或 query 用于关键字搜索。
发展
npm run dev # Watch mode (recompiles on save)
npm run build # One-time build
npm start # Run the server directly使用MCP检查器进行交互式测试：
npx @modelcontextprotocol/inspector node build/index.js归因与致谢
该项目采用了从优秀的 UE5 MCP服务器.
- 项目：UE5 MCP服务器
- 作者纳塔利·卡吉亚诺（Natfii）
- 链接:
看 THIRD-PARTY-NOTICES.txt 获取完整的许可证详细信息。
许可证
麻省理工学院