Godot Project Doctor — PlayMCP 출품본

GodotFunctionRefactor의 분석·리팩터링 계획 기능을 공개 MCP 서비스에 맞게 안전하게 재구성한 출품용 복사본입니다. 사용자의 프로젝트 파일을 서버가 직접 수정하지 않으며, 전달받은 GDScript 텍스트만 메모리에서 처리합니다.

제3자 구성요소와 출품용 권리 표시는 THIRD_PARTY_NOTICES.md, 전체 Node 의존성 목록은 THIRD_PARTY_BOM.md, PlayMCP 입력 문안은 PLAYMCP_SUBMISSION_COPY.md를 참고하세요.

제공 도구

• analyze_gdscript: 스크립트 크기, 함수·signal·export, 역할 혼합과 위험 신호 분석
• plan_godot_refactor: 원본 보존형 단계별 리팩터링 계획과 검증 체크리스트 생성
• generate_godot_service: Godot 4.x RefCounted 서비스 뼈대 생성

출품본은 로컬 AI를 사용하지 않습니다. 카카오의 호출 Agent가 목표와 판단을 담당하고 MCP는 원본 GodotFunctionRefactor.exe의 결정론적 분석·생성·적용·검증 기능을 실행합니다. 전체 분석, factory scan/full/generate/batch/apply, worker board, self-train/self-patch, promotion, chaos restore/verify/drill, Kubernetes 복구 검증, stage backup/refactor/restore, 해시 검증, Tree-sitter, gdtoolkit, AST, 역할 정책, GdUnit4, Godot headless 검사, 셀프테스트·정리와 커스텀 도구 설정을 포함합니다.

prepare_agent_execution은 카카오 Agent의 자연어 목표를 scan → generate → 선택적 sandbox apply → headless/role 검증 순서로 변환합니다. 공개 목록에서는 factory_local_ai_check와 factory_local_ai_plan을 제거했습니다.

파일을 변경할 수 있는 도구는 입력에 confirm_copy: true가 반드시 필요하며, 모든 프로젝트 경로는 GFR_WORKSPACE_ROOT 내부로 제한됩니다.

로컬 실행

pnpm install
$env:PORT=3000
pnpm start

• MCP Endpoint: http://localhost:3000/mcp
• 상태 확인: http://localhost:3000/health
• 전송 방식: Stateless Streamable HTTP

카카오클라우드 배포

docker build -t godot-function-refactor-mcp .
docker run --rm -p 3000:3000 -e PORT=3000 -v /path/to/godot-projects:/workspace godot-function-refactor-mcp

Linux 컨테이너에서는 Mono 런타임으로 기존 .NET Framework 엔진을 실행합니다. Windows 환경에서는 Dockerfile.windows를 사용할 수 있습니다.

카카오클라우드에서 외부 HTTPS Endpoint를 생성한 뒤 https://<endpoint>/mcp를 PlayMCP 개발자 콘솔에 등록합니다.

출품 전 확인

1. 카카오클라우드 MCP 서버 Endpoint 생성
2. PlayMCP에서 임시 등록 후 세 도구 호출 테스트
3. 최종본을 등록 및 심사 요청
4. 승인 후 공개 상태를 반드시 전체 공개로 변경
5. 공모전 페이지에서 Player 예선 참여 제출 — 제출은 1회만 가능

공개 서비스 안전성

• 경로 입력 및 서버 파일 접근 기능 없음
• 명령 실행 기능 없음
• 입력 길이 120,000자로 제한
• 사용자 소스 저장 없음
• 원본 프로젝트 자동 수정 없음

engine/에는 원본 Windows 도구의 배포용 복사본과 규칙 파일을 보관하지만, Linux 컨테이너 이미지에는 포함하지 않습니다.