Skip to main content
Glama

game-agent-factory

AI agent-automated game development pipeline. A multi-agent team (design/program/art/supervisor/QA) orchestrated via LangGraph drives Blender/Krita/Godot/Git through an MCP gateway to automatically produce runnable game build packages.

Construction constraint baseline is in DECISIONS.md; full proposal text is in 智能体游戏施工团队 v2.md.

Architecture Layers

┌────────────────────────────────────────────────────────┐
│ 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

Directory Responsibilities

Directory

Responsibility

contracts/

Delivery contracts: GDD/asset manifest/art spec Schema + validators.py (incl. Kahn cycle detection)

agents/

LangGraph agent definitions (designer/coder/artist3d/artist2d/qa/supervisor)

mcp-servers/common/

Shared infrastructure for the four MCP Servers (socket bridge, audit, parameter validation, path whitelist)

mcp-servers/blender-mcp/

Blender 3D asset production MCP Server

mcp-servers/krita-mcp/

Krita 2D asset production MCP Server

mcp-servers/godot-mcp/

Godot project construction MCP Server

mcp-servers/git-mcp/

Git commit/snapshot/rollback MCP Server (GitPython + LFS)

blender-addon/

Blender plugin (socket bridge + whitelist command executor, belongs to blender-mcp)

godot-plugin/

Godot editor plugin (EditorScript bridge, belongs to godot-mcp)

gateway/

MCP gateway (auth/sandbox/audit/rate limiting)

pipelines/

LangGraph workflow definitions

sandbox/

Whitelist script pool + Docker sandbox

storage/

Repository abstraction layer (SQLiteRepo / ArcadeRepo migratable)

game/

Godot project (managed by Git LFS)

infra/

Gitea/ArcadeDB/Ollama config + versions.env + ports.env + llm.env

logs/

Audit logs

Quick Start

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

# 初始化依赖
just init

# 自检
just check
just all

Environment Baseline

  • OS: Windows single-machine first (code stays Linux-portable)

  • GPU: RTX 2070 8GB

  • LLM: Hybrid mode (local qwen3.5-4b/2b + public API)

  • Blender: 4.2 LTS

  • Godot: 4.4 stable

  • Python: ≥ 3.11, uv package management

See DECISIONS.md §1 for details.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      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.
      43
      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