Skip to main content
Glama

game-agent-factory

AI 에이전트 자동화 게임 개발 파이프라인. 다중 에이전트 팀(기획/프로그래밍/아트/감리/테스트)이 LangGraph로 오케스트레이션되고, MCP 게이트웨이를 통해 Blender/Krita/Godot/Git을 구동하여 실행 가능한 게임 빌드 패키지를 자동으로 산출합니다.

시공 제약 기준선은 DECISIONS.md 참조, 제안서 전문은 智能体游戏施工团队 v2.md 참조.

아키텍처 계층

┌────────────────────────────────────────────────────────┐
│ L0 模型层    Ollama(qwen3.5-4b/2b 本地) + 公有 API(GLM-4 Air/DeepSeek) │
├────────────────────────────────────────────────────────┤
│ L1 编排层    LangGraph(唯一调度层,checkpointer 恢复)         │
│   策划Agent · 程序Agent · 美术Agent(3D/2D) · 监理Agent · 测试Agent │
├────────────────────────────────────────────────────────┤
│ L2 网关层    MCP Gateway:鉴权 · 沙箱 · 白名单 · 路由 · 审计  │
├────────────────────────────────────────────────────────┤
│ L3 适配层    blender-mcp · krita-mcp · godot-mcp · git-mcp │
│             共享 mcp-servers/common/(socket桥/审计/校验/路径白名单)│
├────────────────────────────────────────────────────────┤
│ L4 基础设施   Gitea+LFS · SQLite(记忆/工单/锁/审计) · Ollama(Win原生)│
│             storage/ Repository 抽象层(SQLiteRepo→ArcadeRepo 可迁移)│
└────────────────────────────────────────────────────────┘

Related MCP server: Hearth

디렉터리 역할

디렉터리

역할

contracts/

전달 계약: GDD/에셋 목록/아트 사양 Schema + validators.py(Kahn 사이클 검사 포함)

agents/

LangGraph 에이전트 정의(designer/coder/artist3d/artist2d/qa/supervisor)

mcp-servers/common/

4개 MCP Server 공유 인프라(socket 브리지, 감사, 매개변수 검증, 경로 화이트리스트)

mcp-servers/blender-mcp/

Blender 3D 에셋 생산 MCP Server

mcp-servers/krita-mcp/

Krita 2D 에셋 생산 MCP Server

mcp-servers/godot-mcp/

Godot 프로젝트 시공 MCP Server

mcp-servers/git-mcp/

Git 커밋/스냅샷/롤백 MCP Server(GitPython + LFS)

blender-addon/

Blender 플러그인(socket 브리지 + 화이트리스트 명령 실행기, blender-mcp 소속)

godot-plugin/

Godot 에디터 플러그인(EditorScript 브리지, godot-mcp 소속)

gateway/

MCP 게이트웨이(인증/샌드박스/감사/속도 제한)

pipelines/

LangGraph 워크플로 정의

sandbox/

화이트리스트 스크립트 풀 + Docker 샌드박스

storage/

Repository 추상화 계층(SQLiteRepo / ArcadeRepo 마이그레이션 가능)

game/

Godot 프로젝트(Git LFS 관리)

infra/

Gitea/ArcadeDB/Ollama 구성 + versions.env + ports.env + llm.env

logs/

감사 로그

빠른 시작

# 安装 just(跨平台任务入口)
winget install Casey.Just

# 初始化依赖
just init

# 自检
just check
just all

환경 기준

  • OS: Windows 단일 머신 우선(코드는 Linux 이식 가능 유지)

  • GPU: RTX 2070 8GB

  • LLM: 혼합 모드(로컬 qwen3.5-4b/2b + 공용 API)

  • Blender: 4.2 LTS

  • Godot: 4.4 stable

  • Python: ≥ 3.11, uv 패키지 관리

자세한 내용은 DECISIONS.md §1 참조.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    AI-native open-source 2D game engine whose MCP server exposes every editor operation to coding agents as typed commands, so an agent can build, run, and verify a game inside the editor. It runs locally on macOS, Windows, and Linux with no cloud service or API key.
    48
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Aggregates game-development MCP servers (Blender, Godot, GitHub, Obsidian) behind one interface for AI clients, with smart task routing and a local GUI for multi-client support.
    5
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Autonomous game development framework that lets AI agents program, design scenes, and run visual QA on Godot 4.x projects — all through the Model Context Protocol (MCP).
    MIT