GodotForgeMCP / godot-forge

godot-forge는 Godot 4.5→4.8-dev를 위한 안전하고 점진적 공개(progressive-disclosure) 방식의 MCP 서버 + Godot 에디터 애드온 + MCP 앱 캔버스로 구축되고 있습니다.

현재 상태: M0 스켈레톤.

현재 동작하는 기능

• TypeScript/Node 20+ MCP 서버 스켈레톤.

• stdio를 통한 MCP 2026-07-28 협상.

• MCP 라우팅 헤더가 포함된 무상태(stateless) HTTP JSON-RPC 스켈레톤.

• Godot 바이너리, 프로젝트 루트, C# 프로젝트 파일, GDScript LSP TCP 6005에 대한 기능 프로브.

• 정확히 5개의 상시 활성 도구:

  • forge_search_tools

  • forge_describe_tool

  • forge_run

  • forge_inspect

  • forge_task_status

• M0 스텁 작업을 위한 지속형 태스크-심(task-shim) 저장소.

• 도구 토큰 예산 측정 게이트.

• MCP 협상을 검증하고, Ollama가 실행 중이 아닐 때 gracefully 보고하는 로컬 클라이언트/Ollama 스모크 스크립트.

Related MCP server: GoPeak

빠른 시작

npm install
npm run build
npm test
npm run smoke
npm run probe

MCP stdio 서버로 실행:

node dist/index.js

HTTP 스켈레톤 실행:

node dist/index.js --http --host 0.0.0.0 --port 3333

클라이언트 구성 예시는 docs/M0_RUNBOOK.md를 참조하세요.

설계 문서

• docs/PRIOR_ART.md

• docs/ARCHITECTURE.md

• docs/TOOLS.md

• docs/DECISIONS_AND_SCOPE.md

• docs/M0_RUNBOOK.md

라이선스

MIT. 다른 프로젝트의 코드 혹은 이를 기반으로 한 코드가 통합되는 대로, prior-art 크레딧과 구현 파생 고지사항이 유지됩니다.