Schema | CocosMCP

CocosMCP

Overview Schema Source Related Servers Discussions Admin

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
No arguments

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": true }
`prompts`	{ "listChanged": true }
`resources`	{ "listChanged": true }

Tools

Functions exposed to the LLM to take actions

Name	Description
cocos_projectsA	列出服务启动时注册的工程
cocos_instancesA	列出指定工程已打开的 Creator 实例，不返回认证凭据
cocos_capability_searchD	搜索操作目录；先查询再执行长尾功能
cocos_capability_describeB	获取精确参数 Schema、版本范围、副作用和验证状态
cocos_coverageB	查看提案全部 54 个模块的实现和验证缺口
cocos_capability_executeA	创建资源前必须调用 asset.location，复用已有类型目录；后续使用结果的 assetLocation.url，禁止假定 assets 根路径。整理已有资源先 asset.organize.plan，审查引用后用相同范围及 planHash 调用 asset.organize.apply。按能力详情的 Schema 执行。修改前建议传 expectedRevision 和稳定 operationId。执行器不会执行任意 eval。
cocos_assets_organize_planB	按资源类型规划整理，优先已有目录；返回源/目标、UUID、冲突与跳过原因。默认仅 assets 根目录，agent 审查路径引用后再执行。
cocos_assets_organize_applyB	执行已审查计划；必须保留预览范围和 planHash。通过 AssetDB 移动保留 UUID，遇到变化拒绝，部分失败返回恢复记录。
cocos_workflow_planB	批量校验能力参数、版本、风险和副作用；规划不会修改工程
cocos_workflow_executeB	按顺序执行已规划能力；默认遇到失败即停止，并返回已完成步骤和补偿提示
cocos_workflow_statusC	查询持久化工作流的步骤进度、失败位置和最终结果
cocos_operation_queryB	超时或断线后查询 operationId，避免重复执行修改
cocos_runtime_instancesB	列出已连接的开发运行实例
cocos_build_startA	使用 Creator CLI 构建已注册工程并返回任务 ID；构建需要本机 GUI 和已安装的平台工具
cocos_build_statusB	查询构建任务状态、产物和日志路径
cocos_build_listB	列出工程的构建任务
cocos_build_logsC	分页读取构建日志
cocos_build_cancelC	取消正在执行的构建任务
cocos_scene_queryC	读取当前场景信息和修改状态
cocos_scene_snapshotC	生成可重放的当前场景序列化快照
cocos_scene_diffC	将当前场景与基线快照进行结构化差异比较
cocos_scene_hierarchyD	分页读取场景层级
cocos_scene_openC	打开已有场景；有未保存修改时拒绝切换
cocos_scene_saveD	保存当前场景并查询修改状态
cocos_node_queryC	读取节点及组件属性
cocos_node_createC	创建节点并返回实际节点信息
cocos_node_setC	编辑节点属性并读回验证
cocos_component_addD	添加内置或项目脚本组件
cocos_component_setC	修改组件属性和引用并读回验证
cocos_asset_queryC	查询资源；支持类型和路径过滤
cocos_asset_importD	导入工程目录内的文件
cocos_prefab_instantiateD	实例化预制体到场景
cocos_ui_buildC	从声明式节点树构建 UI；失败时补偿本次创建的节点
cocos_scene_validateC	检查缺失组件与无效对象引用
cocos_runtime_captureD	捕获当前游戏 Canvas 图像