개발 문서
MCP · AI Skill
MCP 서버는 로컬 stdio 방식입니다. MCP를 지원하는 클라이언트에 아래 실행 정보를 등록합니다. IMMERCY_PROJECT_DIR는 게임 소스 폴더이며 그 안에 immercy.config.json이 있어야 합니다. command는 PATH의 Node.js 24 실행 파일 또는 절대 경로를 사용합니다.
{
"mcpServers": {
"immercy": {
"command": "node",
"args": ["C:/Projects/Immercy/packages/mcp/src/index.js"],
"env": {
"IMMERCY_PROJECT_DIR": "C:/Projects/Immercy/examples/starter",
"IMMERCY_CONFIG": "immercy.config.json"
}
}
}
}
위 JSON은 mcpServers 형식을 사용하는 클라이언트의 예시입니다. 다른 클라이언트에서는 같은 command/args/env 값을 해당 설정 형식으로 옮깁니다. API 키는 클라이언트의 안전한 환경 변수 전달 기능 또는 게임 폴더의 Git 제외 .immercy.local.json에 넣습니다. 서버는 지정된 폴더와 프로젝트 ID에 묶이며 도구 인자로 임의 쉘 명령을 받지 않습니다.
| MCP 도구 | 동작 |
|---|---|
immercy_help | SDK/컨트롤러/배포 계약 설명 |
immercy_validate_controller | 전달된 컨트롤러 데이터 검증 |
immercy_inspect_build | 지정된 로컬 빌드의 manifest·해시·크기 검토 |
immercy_get_project | 해당 프로젝트의 실제 서버 메타데이터 조회 |
immercy_preview_links | 에디터/Integration Preview/게임 링크 반환 |
immercy_update_controller | 서버의 컨트롤러 데이터 변경 |
immercy_deploy | 완성된 정적 빌드 업로드와 최신 빌드 교체 |
가이드 resource는 immercy://guide, 게임 제작 prompt는 immercy-game입니다. 재사용 안내는 packages/mcp/skills/immercy-game/SKILL.md에 포함됩니다. 이 파일을 포함한 패키지는 준비되어 있으며 사용자의 MCP 클라이언트에 자동 설치하거나 시작하지 않았습니다.
조회/검증과 원격 변경 도구를 구분합니다. immercy_preview_links는 브라우저를 열거나 Play를 시작하지 않습니다. immercy_update_controller와 immercy_deploy는 실제 서버 자료를 바꾸므로 개발 도구에 요청한 작업 범위 안에서 사용합니다. 게임 빌드는 MCP가 쉘로 자동 실행하지 않으며 배포는 이미 완성된 출력물을 사용합니다.