The Most Advanced MCP Server for Cocos Creator Editor with `execute_javascript`, prompts/resources, screenshots, asset dependency validation, tool profiles, one-click client configuration, and editor automation.

Cocos용 Funplay MCP – AI 지원 Cocos Creator 확장 프로그램

정의 – MIT 라이선스 기반 Cocos Creator 편집기 확장 프로그램으로, 편집기 내부에 임베디드 HTTP MCP(Machine-Code-Protocol) 서버를 실행합니다. 이 서버는 AI 코딩 어시스턴트(Claude Code, Cursor, VS Code Copilot 등)가 execute_javascript와 같은 도구를 호출하여 Cocos 프로젝트를 실시간으로 검사하거나 수정할 수 있게 합니다.

핵심 개념

이 확장 프로그램은 로컬 HTTP JSON-RPC 엔드포인트(기본 포트 8765 또는 프로젝트 기반 포트 20000-29999)를 시작합니다.
AI 클라이언트는 해당 엔드포인트에 연결하여 MCP 도구를 호출합니다. 이는 씬이나 편집기에서 JavaScript를 실행하고, 에셋을 읽고, 스크린샷을 캡처하고, 씬을 나열하는 등의 사전 정의된 작업입니다.
주요 도구는 execute_javascript로, 씬 런타임 또는 편집기 UI 컨텍스트에서 임의의 JavaScript를 실행할 수 있습니다.
다른 모든 도구는 이를 기반으로 구축되어, AI 에이전트가 UI 생성, 에셋 검사, 디버깅 등을 자동화할 수 있는 간결하지만 강력한 인터페이스를 제공합니다.

주요 기능

기능	제공 내용
임베디드 서버	외부 데몬 없음; MCP 서버는 Cocos Creator 확장 프로그램 내부에 있으며 편집기 메뉴(`Funplay > MCP Server`)에서 시작/중지됩니다.
원클릭 클라이언트 구성	패널은 인기 있는 AI 어시스턴트(Claude Code, Cursor, VS Code, Trae, Kiro, Qoder, Kimi Code, Codex, OpenCode)용 즉시 사용 가능한 JSON-RPC 구성 스니펫을 작성합니다.
두 가지 실행 컨텍스트	`context: "scene"`은 활성 게임 씬에서 JavaScript를 실행하고, `context: "editor"`는 편집기/브라우저 UI에서 실행합니다.
도구 프로필	`core`(39개의 고신호 도구), `full`(106개 도구) 또는 카테고리를 활성화/비활성화할 수 있는 사용자 지정 프로필.
안전 검사	기본적으로 위험한 파일 시스템 또는 셸 호출을 차단합니다; 위험을 수용한다면 호출별로 비활성화할 수 있습니다.
스크린샷 및 입력 시뮬레이션	편집기, 씬 또는 미리보기 스크린샷을 캡처하고 마우스/키보드 이벤트를 AI 클라이언트로 다시 보냅니다.
전역 설치 옵션	모든 Cocos Creator 프로젝트에 대해 한 번 설치; 확장 프로그램은 GitHub 릴리스에서 자동 업데이트되고 SHA-256 체크섬을 검증합니다.
디버그 도우미	빠른 curl 확인을 위한 간단한 `GET /health` 및 `GET /tools` 엔드포인트; 패널 내 최근 활동 로그 보기.
npm stdio 래퍼	stdio 기반 MCP 클라이언트를 임베디드 HTTP 서버에 연결하는 선택적 `funplay-cocos-mcp` 명령.

일반적인 워크플로우

설치 – Cocos Store를 통해 또는 저장소를 프로젝트의 extensions/ 폴더에 복제하여 설치합니다(또는 모든 프로젝트에 설치 버튼 사용).
서버 시작 – Funplay > MCP Server → 활성화. 패널에 정확한 URL과 포트가 표시됩니다.
AI 클라이언트 구성 – Claude Code, Cursor 등에 대해 원클릭 구성을 클릭합니다; 확장 프로그램이 클라이언트의 구성 파일에 올바른 JSON-RPC 항목을 작성합니다.
요청 보내기 – AI 어시스턴트에게 execute_javascript를 실행하도록 요청합니다(예: 로그인 UI 생성, 에셋 나열, 스크린샷 캡처). 어시스턴트는 JSON-RPC 응답을 받고 결과를 검사하며 반복할 수 있습니다.
반복 – 최근 활동 보기를 사용하여 각 호출, 콘솔 출력 및 반환된 데이터를 확인합니다.

사용 대상

게임 개발자 – Cocos Creator에서 이미 작업 중이며 AI 기반 코드 생성, UI 프로토타이핑 또는 자동화된 디버깅을 원하는 개발자.
AI 어시스턴트 개발자 – 실제 편집기 환경에서 도구를 테스트할 수 있는 즉시 사용 가능한 MCP 엔드포인트를 찾는 개발자.
도구 빌더 – 사용자 지정 플러그인을 작성하지 않고 Cocos 씬을 스크립팅할 수 있는 안정적인 JSON-RPC 인터페이스가 필요한 개발자.

성숙도 및 상태

버전 관리 – GitHub 릴리스를 따릅니다; 확장 프로그램은 자동으로 업데이트를 확인할 수 있습니다.
안정성 – 핵심 기능(execute_javascript, 프로젝트 정보, 에셋 검사, 스크린샷)은 안정적으로 표시됩니다. 고급 도구 세트(full 프로필)는 사용 가능하지만 변경될 수 있습니다.
플랫폼 – 편집기 전용; 최종 게임 빌드에 런타임 코드를 추가하지 않습니다.
지원되는 Cocos Creator – 3.8 이상(macOS, Linux, Windows에서 테스트됨).

라이선스

MIT – 상업적 및 비상업적 용도로 무료이며, 저작자 표시가 필요합니다.

결론 – Cocos용 Funplay MCP는 현대 AI 코딩 어시스턴트와 Cocos Creator 편집기 사이에 플러그 앤 플레이 브리지를 제공하여, AI가 단일하고 잘 문서화된 HTTP JSON-RPC 서버를 통해 씬, 에셋 및 편집기 상태를 조작할 수 있게 합니다.

FunplayAI/funplay-cocos-mcp