Gear

Gear를 사용하면 AI 어시스턴트가 귀하의 Godot 프로젝트를 직접 실행, 검사, 수정 및 디버깅할 수 있습니다.

빠른 시작 (3분)

환경 요구 사항

• Godot 4.x

• Node.js 18+

• MCP 지원 클라이언트 (Claude Desktop, Cursor, Cline 등)

1) Gear 실행

npx -y gear

또는 전역 설치:

npm install -g gear-godot-mcp
gear

2) MCP 클라이언트 설정

Claude Desktop 등 클라이언트의 설정 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "gear"],
      "env": {
        "GODOT_PATH": "/path/to/godot"
      }
    }
  }
}

3) 다음 명령어들을 시도해 보세요

• "/your/projects 디렉터리에 있는 모든 Godot 프로젝트 나열"

• "scenes/Player.tscn 생성, 루트 노드는 CharacterBody2D로 설정"

• "프로젝트 실행, 디버그 출력 가져오기, 오류 수정"

Related MCP server: Godot MCP Enhanced

Gear를 사용하는 이유

핵심 장점

사용 사례

• ✅ AI를 활용해 개발 속도를 높이려는 1인 개발자

• ✅ AI가 실제 프로젝트/런타임 상태를 이해해야 하는 팀

• ✅ 고도화된 디버깅 워크플로우 (중단점, 스택 추적, 런타임 검사)

도구 사용 모드

도구 노출 수준

Gear는 세 가지 도구 노출 모드를 제공합니다:

compact 모드의 동적 도구 그룹

compact 모드에서는 78개의 추가 도구가 22개의 동적 도구 그룹으로 구성됩니다:

도구 그룹 사용 방법

1. 자동 활성화 (권장)

tool.catalog를 사용하여 관련 도구를 검색하면 일치하는 도구 그룹이 자동으로 활성화됩니다.

2. 수동 활성화

tool.groups를 사용하여 특정 도구 그룹을 수동으로 활성화합니다. "디버깅을 위해 dap 도구 그룹 활성화"

3. 비활성화

tool.groups를 사용하여 활성화된 그룹을 재설정합니다.

설치 방법

방법 A: npx (권장)

npx -y gear

방법 B: 전역 설치

npm install -g gear-godot-mcp
gear

방법 C: 소스 코드 설치

git clone https://github.com/HaD0Yun/Gear-godot-mcp.git
cd Gear-godot-mcp
npm install
npm run build
node build/index.js

기능 요약

장면 편집

• 장면 생성, 노드 추가/삭제

• 노드 속성 수정

• 노드 부모 재설정

스크립트 워크플로우

• 스크립트 생성/수정

• 스크립트 구조 분석

• 심볼 이름 변경

런타임 디버깅

• 런타임 장면 트리 검사

• 중단점 설정, 단계별 실행

• 변수 값 확인

입력 및 스크린샷

• 키보드/마우스 입력 주입

• 게임 화면 캡처

• 뷰포트 캡처

에셋 관리

• CC0 에셋 검색 (Poly Haven, AmbientCG, Kenney)

• 프로젝트로 에셋 다운로드

환경 변수

자주 묻는 질문

관련 링크

• 아키텍처 문서

• 개발 로드맵

• 변경 로그

• 기여 가이드

라이선스

MIT — 자세한 내용은 LICENSE를 참조하세요.

감사의 말

• 원본 MCP 서버: Coding-Solo

• Gear 기능 강화: HaD0Yun

• 프로젝트 시각화 기능 영감: tomyud1/godot-mcp