funplayai avatar

Funplay Cocos MCP

funplayai/funplay-cocos-mcp

Embeds an HTTP MCP server directly inside Cocos Creator 3.8+ so Claude and other AI assistants can inspect and manipulate your running game project. The core workflow is execute_javascript with two contexts: "scene" runs code in your active Cocos scene runtime, "editor" runs it in the browser editor environment. You can ask your AI to build UI hierarchies, attach components, query the scene graph, and capture screenshots for validation. Ships with 34 focused tools in core mode or 89 in full, plus cocos:// resource URIs for project inspection and a one-click config generator for Claude Desktop, Cursor, VS Code, and others. Install it as a Cocos extension, start the server from the Funplay menu, and point your client at localhost:8765.

GitHub stars
393
tools
80
transport
STDIO
env vars
2
last updated
Nov 10, 2026

Tools

80 tools

Public tool metadata for what this MCP can expose to an agent.

execute_javascriptPrimary execution tool for scene/runtime and editor/browser automation.

Primary execution tool for scene/runtime and editor/browser automation.

No parameter schema in public metadata yet.

execute_scene_script

No parameter schema in public metadata yet.

execute_editor_script

No parameter schema in public metadata yet.

get_editor_state

No parameter schema in public metadata yet.

get_tool_catalog

No parameter schema in public metadata yet.

check_for_updates

No parameter schema in public metadata yet.

get_selection

No parameter schema in public metadata yet.

set_selection

No parameter schema in public metadata yet.

get_editor_selection

No parameter schema in public metadata yet.

list_project_instructions

No parameter schema in public metadata yet.

read_project_instruction

No parameter schema in public metadata yet.

write_project_instruction

No parameter schema in public metadata yet.

create_project_skill

No parameter schema in public metadata yet.

create_cocos_mcp_project_skill

No parameter schema in public metadata yet.

get_project_info

No parameter schema in public metadata yet.

get_scene_info

No parameter schema in public metadata yet.

get_hierarchy

No parameter schema in public metadata yet.

find_nodes

No parameter schema in public metadata yet.

inspect_node

No parameter schema in public metadata yet.

list_scenes

No parameter schema in public metadata yet.

open_scene

No parameter schema in public metadata yet.

run_scene_asset

No parameter schema in public metadata yet.

create_node

No parameter schema in public metadata yet.

delete_node

No parameter schema in public metadata yet.

set_node_transform

No parameter schema in public metadata yet.

list_assets

No parameter schema in public metadata yet.

inspect_asset

No parameter schema in public metadata yet.

inspect_asset_dependencies

No parameter schema in public metadata yet.

validate_asset_dependencies

No parameter schema in public metadata yet.

check_asset_ready

No parameter schema in public metadata yet.

open_asset

No parameter schema in public metadata yet.

select_asset

No parameter schema in public metadata yet.

delete_asset

No parameter schema in public metadata yet.

list_prefabs

No parameter schema in public metadata yet.

inspect_prefab

No parameter schema in public metadata yet.

validate_prefab_references

No parameter schema in public metadata yet.

duplicate_prefab

No parameter schema in public metadata yet.

edit_prefab_json

No parameter schema in public metadata yet.

create_prefab_from_node

No parameter schema in public metadata yet.

create_prefab_instance

No parameter schema in public metadata yet.

inspect_prefab_instance

No parameter schema in public metadata yet.

apply_prefab_instance

No parameter schema in public metadata yet.

revert_prefab_instance

No parameter schema in public metadata yet.

instantiate_prefab

No parameter schema in public metadata yet.

list_components

No parameter schema in public metadata yet.

inspect_component

No parameter schema in public metadata yet.

add_component

No parameter schema in public metadata yet.

remove_component

No parameter schema in public metadata yet.

set_component_property

No parameter schema in public metadata yet.

reset_component_property

No parameter schema in public metadata yet.

create_canvas

No parameter schema in public metadata yet.

create_label

No parameter schema in public metadata yet.

create_button

No parameter schema in public metadata yet.

create_sprite

No parameter schema in public metadata yet.

list_cameras

No parameter schema in public metadata yet.

create_camera

No parameter schema in public metadata yet.

set_camera_properties

No parameter schema in public metadata yet.

list_animations

No parameter schema in public metadata yet.

add_animation_clip

No parameter schema in public metadata yet.

play_animation

No parameter schema in public metadata yet.

stop_animation

No parameter schema in public metadata yet.

read_file

No parameter schema in public metadata yet.

get_file_snippet

No parameter schema in public metadata yet.

write_file

No parameter schema in public metadata yet.

replace_in_file

No parameter schema in public metadata yet.

search_files

No parameter schema in public metadata yet.

list_directory

No parameter schema in public metadata yet.

exists

No parameter schema in public metadata yet.

refresh_assets

No parameter schema in public metadata yet.

run_script_diagnostics

No parameter schema in public metadata yet.

get_script_diagnostic_context

No parameter schema in public metadata yet.

get_recent_logs

No parameter schema in public metadata yet.

search_project_logs

No parameter schema in public metadata yet.

clear_logs

No parameter schema in public metadata yet.

validate_scene

No parameter schema in public metadata yet.

get_performance_snapshot

No parameter schema in public metadata yet.

get_build_status

No parameter schema in public metadata yet.

get_preview_mode

No parameter schema in public metadata yet.

set_preview_mode

No parameter schema in public metadata yet.

open_build_panel

No parameter schema in public metadata yet.

Sponsors

Configuration

FUNPLAY_COCOS_MCP_URL

Optional local Cocos MCP HTTP endpoint. Defaults to http://127.0.0.1:8765/.

FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS

Optional HTTP timeout per request in seconds. Defaults to 120.

Readme

Funplay MCP for Cocos

An Embedded MCP Server for Cocos Creator Editor

Cocos Creator 3.8+ License: MIT MCP Compatible Editor Only Install from Cocos Store

中文 | English

If this project helps your Cocos workflow, please consider giving it a Star. It helps more developers discover the project and supports ongoing development.

For discussion and feedback, join our QQ group: 1108522331. Open Funplay > Contact & Feedback to find the author's email and copy either contact detail.



View the full README on GitHub

Details

Repository
github.com/funplayai/funplay-cocos-mcp
Package
funplay-cocos-mcp
Transport
STDIO
Registry
MCP registry, active

More from funplayai