Install the cocos-mcp-server plugin in the Cocos Creator project.
Constants
- Git repository:
https://github.com/TinycellCorp/cocos-mcp-server.git - Installation path:
extensions/cocos-mcp-server
Procedure
1. Verify Cocos Creator project
In the current directory, assets/ check whether the folder exists.
ls assets/
- If not: after guiding with "The current directory is not a Cocos Creator project. Please run it from the Cocos Creator project root.", stop
2. Install plugin
extensions/cocos-mcp-server/package.json Branch depending on whether it exists.
ls extensions/cocos-mcp-server/package.json
If it already exists (update)
After guiding with "An existing installation was detected. Updating.", pull.
git -C extensions/cocos-mcp-server pull
If it does not exist (new installation)
git clone https://github.com/TinycellCorp/cocos-mcp-server.git extensions/cocos-mcp-server
- On error: after guiding with "Plugin installation failed.", stop
3. Install dependencies
--prefix Specify the target directory with the option. (cd Do not use - ensure allowed-tools matching)
npm install --production --prefix extensions/cocos-mcp-server
- On error: after guiding with "npm install failed.", stop
4. Result guidance
When all steps are complete, output the following:
## 설치 완료
플러그인: extensions/cocos-mcp-server/
### 다음 단계
1. Cocos Creator 에디터에서 프로젝트를 열고 Extension 패널에서 MCP 서버를 시작하세요.
2. 에디터에서 설정한 포트 번호를 확인한 뒤 아래 명령어로 MCP 서버를 등록하세요.
MCP 헬스체크:
curl http://127.0.0.1:{포트}/mcp
MCP 등록:
claude mcp add --transport http --scope local cocos-creator http://127.0.0.1:{포트}/mcp
Error handling
- If an error occurs at any step, do not retry with another method do not
- Show the error content to the user as is and stop immediately.