fennaraOfficial/fennara-godot-ai

Godot 에디터에 AI 에이전트를 연결해 실시간 장면 검사, 스크립트 분석, 런타임 오류 캡처를 지원하는 MCP 서버

개발 재료맘대로 써도 됨 · MIT코딩 보조·CLI 에이전트C++난이도
135+98이번 주0 찜
3포크1이슈

중간맛 분석

Godot 4.5+ 전용 도구로, Windows/Linux/macOS에서 동작합니다. C++ 기반의 로컬 MCP 서버와 데몬, Godot 애드온으로 구성되며, (fennara 명령어)로 설치합니다. 외부 MCP 앱(Claude Code, Cursor, Gemini 등)은 자체 모델을 사용하고, 내장 채팅 도구는 OpenAI/Anthropic/Ollama 등 별도로 설정합니다. 바로 쓸 수 있으며 유튜브 데모 영상이 풍부합니다.

이런 레포예요

이럴 때 쓰면 좋아요

  • AI 에이전트가 실제 씬 상태를 보며 게임 개발을 돕도록 할 때
  • 파일 편집 도구만으로는 부족한 Godot 고유 요소(노드 경로, exported variables, 런타임 로그)를 AI에게 제공하고 싶을 때
  • 로컬 모델(Ollama, LM Studio)과 Godot 프로젝트 인식형 채팅을 하고 싶을 때

핵심 기능

실시간 씬 검사 및 노드 트리 분석런타임 로그, 오류, 스크린샷 캡처내장 웹 기반 채팅 도구 (다양한 로컬/클라우드 모델 지원)

대안 대비 차별점

파일 기반 분석만 하는 다른 Godot MCP와 달리, 에디터 런타임과 직접 통신하여 실제 씬 상태, 내보낸 변수, 런타임 오류를 AI 에이전트가 직접 확인할 수 있습니다.

준비물

  • Godot 4.5 이상
  • Windows x86_64, Linux x86_64, 또는 macOS arm64
  • Claude Code, Codex, Cursor, Gemini 등의 MCP 호환 AI 코딩 도구

바로 시작하기

  1. Windows용 CLI 설치 (관리자 권한 불필요)
irm https://raw.githubusercontent.com/fennaraOfficial/fennara-godot-ai/main/install.ps1 | iex

또는 macOS/Linux의 경우:

curl -fsSL https://raw.githubusercontent.com/fennaraOfficial/fennara-godot-ai/main/install.sh | sh

설치 확인:

fennara doctor
  1. Godot 프로젝트 폴더에서 Fennara 추가
cd path/to/your-godot-project
fennara install

C# 프로젝트의 경우:

fennara install --csharp

그 후 Godot에서 프로젝트를 엽니다.

  1. 사용할 MCP 앱 설정 (예: Claude Code)
fennara mcp-setup --claude

Cursor를 사용하는 경우:

fennara mcp-setup --cursor

설정 후 해당 앱을 재시작합니다.

  1. 동작 확인 (Godot 프로젝트 열린 상태) MCP 앱에서 다음을 요청합니다:
Use Fennara MCP to run fennara_status and tell me which Godot project is connected.
  1. 나중에 업데이트 (프로젝트 폴더에서)
fennara update

별 추이 · 7일

135+98 / 7일

활용성 · 따라 만들기 좋은가

따라 하기 좋음샘플 점수 58/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

이 레포에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/fennaraOfficial/fennara-godot-ai.svg)](https://www.gitbap.com/r/fennaraOfficial/fennara-godot-ai)

🔌 클로드에서 바로 써보기

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기