Skip to main content
Glama
Sign In
forge3d

forge3d

by Darin-Ziloy
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Forge3D AI

A local 3D workspace for AI agents, with headless Blender and a live human viewer.

Build models, import assets, animate scenes, render images, and save versioned projects through MCP or a JSON API. Blender runs in the background; the browser viewer lets you inspect the results without interrupting the agent.

Forge3D workspace

Features

  • AI control: 17 MCP tools, validated JSON schemas, HTTP API, and CLI.

  • Modeling: primitives, custom meshes, object hierarchies, and common modifiers.

  • Textures and UV: PNG/JPEG assets, albedo/normal/roughness/metallic maps, explicit atlas UVs, smart unwrap, and high-to-low baking.

  • Look development: PBR materials, camera, lighting, and Cycles/Eevee rendering.

  • Animation: transform keyframes, GLB animation playback, and PNG frame sequences.

  • Import: GLB/glTF, OBJ with MTL, STL, and FBX, with supported dependencies copied into the project.

  • Export: GLB, optional mesh-only FBX, packed .blend, external PNG textures, UV layouts, asset bundles, and project ZIP archives.

  • Persistence: autosave, revision history, restore, and portable project reopening.

  • Viewer: orbit, pan, zoom, wireframe, timeline, job progress, logs, and render preview.

Related MCP server: Blender Open MCP

Quick start on Windows

Requires Python 3.11+, an installed or portable Blender, and Node.js/npm to prepare the viewer. Node.js is unnecessary when installing a source bundle that already includes the prepared viewer files.

git clone https://github.com/Darin-Ziloy/forge3d-ai.git
cd forge3d-ai
.\Setup.ps1
.\Start-Forge3D.cmd

Open localhost:8765. Run Start-Demo.cmd to generate an animated inspection drone and a render. Use Stop-Forge3D.cmd to stop the background service.

If Blender is not found automatically, set its path before starting:

$env:BLENDER_PATH = 'D:\Tools\Blender\blender.exe'
.\.venv\Scripts\python.exe -m forge3d start

Viewer controls: left drag to orbit, right drag to pan, scroll to zoom, and F to frame the model.

Connect your AI

Setup generates a local mcp-config.json. Add its mcpServers.forge3d entry to your MCP client's configuration. To regenerate it:

.\.venv\Scripts\python.exe -m forge3d mcp-config

The MCP server uses stdio and starts the shared local service on demand. Your AI host must support MCP tools; cloud-only clients need a local bridge. Agents without MCP can use the JSON API or CLI.

Example request: "Create a desk lamp with a metal stand and a matte green shade. Animate a turn over 120 frames, render the first frame, and save the project."

Import and save projects

.\.venv\Scripts\python.exe -m forge3d create 'My project'
.\.venv\Scripts\python.exe -m forge3d import PROJECT_ID 'C:\Models\robot.glb'
.\.venv\Scripts\python.exe -m forge3d save PROJECT_ID
.\.venv\Scripts\python.exe -m forge3d open 'C:\Archives\project.zip'

Import returns an asset reference. Place it in a scene with an object of type import; see the user guide. Every successful build is already autosaved. ZIP archives provide portable copies with assets and revision history. The viewer currently downloads outputs; model import is performed through MCP or CLI.

Status and scope

Version 0.2.0 is a working prototype, using Blender as its 3D engine. It is not a complete replacement for Blender's authoring tools. Typed operations cover the basic pipeline; advanced bpy scripting is an explicit opt-in for trusted agents.

Tested on Windows 10, Python 3.14.4, and Blender 5.2.2 LTS. Windows 11 is a target platform and has not yet been separately verified. Validation report.

Current limits include one worker at a time, CPU rendering by default, no standard OBJ/STL export commands, no import button in the viewer, and no remote MCP endpoint. Rigging, interactive texture painting, simulations, and GPU selection are on the roadmap.

Documentation

License

Forge3D source code is GPL-3.0-or-later. Blender is installed separately. Third-party components retain their licenses. This project is independent and is not affiliated with the Blender Foundation.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers

  • Blender Open MCP

    Wichais71
    F
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to control a live Blender session through MCP tools for scene/object manipulation, rendering, PolyHaven asset access, and guided scene-building prompts. It supports provider-agnostic LLM backends that can be configured or switched at runtime.
    -

  • Blender Open MCP

    Gerald2348
    F
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to control a live Blender session through MCP tools for scene inspection, object creation and editing, rendering, and PolyHaven asset management, while supporting provider-agnostic LLM backends that can be switched at runtime.
    -

  • Blender Open MCP

    BorisPhoenix509
    F
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to control a live Blender session by creating, modifying, rendering, and managing scene objects, textures, and PolyHaven assets through MCP tools. It also routes prompts across configurable local or OpenAI-compatible LLM backends that can be switched at runtime.
    -