VoxelForge
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@VoxelForge create a voxel house with a red roof"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
VoxelForge
VoxelForge คือ voxel editor ของเรา สร้างจากแนวคิด Goxel พร้อม MCP bridge ให้ AI ต่างๆ (Cursor, Claude Desktop, ฯลฯ) สร้างและแก้โมเดล 3D ได้โดยตรง
Goxel ต้นฉบับเป็น GPL-3.0 — VoxelForge เป็น implementation ใหม่ที่ออกแบบ MCP-first ไม่ได้ fork โค้ด C ของ Goxel โดยตรง แต่รองรับไฟล์
.vox/.objที่ใช้ร่วมกันได้
ฟีเจอร์
ฟีเจอร์ | รายละเอียด |
24-bit RGB | พาเลตสีเต็ม |
Layers | หลาย layer เหมือน Goxel |
Export |
|
Import |
|
Web Editor | Three.js 3D — คลิกวาง/ลบ voxel |
MCP | เชื่อม Cursor, Claude, client อื่นๆ |
Related MCP server: build-arena
ติดตั้ง
cd C:\Users\thana\Desktop\voxel-forge
uv sync
cd editor
npm installเชื่อม MCP
Cursor (~/.cursor/mcp.json)
"VoxelForge": {
"command": "C:\\Users\\thana\\Desktop\\voxel-forge\\run-mcp.bat",
"args": []
}Claude Desktop
{
"mcpServers": {
"VoxelForge": {
"command": "C:\\Users\\thana\\Desktop\\voxel-forge\\run-mcp.bat",
"args": []
}
}
}รีสตาร์ท client แล้วตรวจ MCP panel ว่า VoxelForge เป็นสีเขียว
Desktop App (ไม่ใช้เบราว์เซอร์)
รันโปรแกรม
cd C:\Users\thana\Desktop\voxel-forge
.\run-desktop.batหรือหลัง uv sync --extra desktop:
uv run voxel-forgeBuild เป็น .exe
.\build-desktop.batได้ที่ dist\VoxelForge\VoxelForge.exe — ดับble-click เปิดได้เลย ไม่ต้องมี Python/เบราว์เซอร์
ฟีเจอร์ Desktop
เปิด/บันทึก scene (JSON)
Import
.vox/ Export.obj(merged),.vox, Roblox LuauCreate → Build Tree (resolution 1–8)
3D view native (Qt3D) — หมุนกล้องด้วยเมาส์กลาง
MCP สำหรับ AI ยังใช้แยก (run-mcp.bat) — สร้าง scene ผ่าน AI แล้วเปิดใน Desktop จาก %USERPROFILE%\.voxel-forge\scenes\
Web Editor (ทางเลือก)
.\run-editor.batเปิด http://localhost:5173 — sync กับ MCP ผ่าน WebSocket ws://127.0.0.1:8765
2. สร้างผ่าน AI
ตัวอย่าง prompt:
สร้างบ้าน voxel แบบ Goxel ชื่อ my_house — ฐาน 8x8 สีเทา ตัวบ้าน 6x6x4 สีขาว หลังคาสามเหลี่ยมสีแดง
AI จะเรียก:
voxelforge_create_scenevoxelforge_fill_box/voxelforge_place_manyvoxelforge_previewตรวจรูปทรงvoxelforge_export_voxหรือvoxelforge_export_obj
3. เปิดใน Goxel จริง
Export .vox แล้วเปิดใน Goxel หรือ MagicaVoxel:
%USERPROFILE%\.voxel-forge\exports\my_house.voxเครื่องมือ MCP หลัก
Tool | หน้าที่ |
| ข้อมูลโปรเจกต์ |
| สร้าง scene ใหม่ |
| วาง voxel จาก JSON |
| เติมกล่อง 3D |
| เพิ่ม layer |
| ดู ASCII preview |
| ส่งออก .vox |
| ส่งออก .obj |
| นำเข้า .vox |
| เปิด web editor |
| บันทึก/โหลด scene |
โฟลเดอร์ข้อมูล
Scenes:
%USERPROFILE%\.voxel-forge\scenes\Exports:
%USERPROFILE%\.voxel-forge\exports\
สถาปัตยกรรม
┌─────────────┐ stdio/MCP ┌──────────────┐ WebSocket ┌─────────────┐
│ Cursor AI │ ◄───────────► │ MCP Server │ ◄──────────► │ Web Editor │
│ Claude etc. │ │ (Python) │ │ (Three.js) │
└─────────────┘ └──────────────┘ └─────────────┘เปรียบเทียบกับ cube-world-voxel-mcp
VoxelForge | cube-world-voxel-mcp | |
จุดประสงค์ | Editor ทั่วไปแบบ Goxel | Roblox Cube World |
ขนาด voxel | 1×1×1 | 2×2×2 studs |
GUI | Three.js editor | ไม่มี (headless) |
Export | .vox, .obj | Luau → Roblox |
ทั้งสองใช้ MCP คู่กันได้ใน Cursor พร้อมกัน
License
MIT — โค้ด VoxelForge เป็นของเรา
Goxel ต้นฉบับ: GPL-3.0 (https://github.com/guillaumechereau/goxel)
Available Tools
27 toolsvoxelforge_aboutA
อธิบาย VoxelForge และความสัมพันธ์กับ Goxel.
Inputs: no named parameters. Returns: result
voxelforge_add_layerC
เพิ่ม layer ใหม่ (เหมือน Goxel).
Inputs: name (required), scene_name. Returns: result
voxelforge_build_chibi_bearB
สร้างรูปปั้นหมี chibi (resolution 2-4 แนะนำ).
Inputs: name, resolution. Returns: result
voxelforge_build_treeB
สร้างต้นไม้ procedural ความละเอียดปรับได้. resolution: 1=หยาบ, 2=ปานกลาง, 4=ละเอียด (แนะนำ), 8=สูงมาก
Inputs: name, resolution. Returns: result
voxelforge_clearC
ล้าง voxel ทั้งหมด.
Inputs: scene_name. Returns: result
voxelforge_create_sceneC
สร้าง scene voxel ใหม่.
Inputs: name (required). Returns: result
voxelforge_default_paletteD
พาเลตสีเริ่มต้น.
Inputs: no named parameters. Returns: result
voxelforge_export_objB
Export เป็น Wavefront .obj — merge_boxes=true รวม voxel ติดกัน (แนะนำ).
Inputs: scene_name, merge_boxes, output_path. Returns: result
voxelforge_export_obj_legacyC
Export เป็น Wavefront .obj (Goxel รองรับ).
Inputs: scene_name, output_path. Returns: result
voxelforge_export_roblox_mergedA
Export Luau สำหรับ Roblox — รวม voxel เป็น Part ใหญ่ใน Model เดียว (ลดแลag). ใช้ Roblox_Studio MCP execute_luau (Edit mode) รันโค้ดที่ได้
Inputs: scene_name, output_path. Returns: result
voxelforge_export_voxC
Export เป็น .vox (เปิดใน Goxel / MagicaVoxel ได้).
Inputs: scene_name, output_path. Returns: result
voxelforge_fill_boxC
เติ่มกล่อง 3D (เหมาะสร้างฐาน/ตัวบ้าน/กำแพง).
Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +4 more. Returns: result
voxelforge_get_infoD
ข้อมูล scene เป็น JSON.
Inputs: scene_name. Returns: result
voxelforge_import_voxC
Import ไฟล์ .vox (MagicaVoxel / Goxel export format).
Inputs: file_path (required). Returns: result
voxelforge_launch_editorA
เปิด VoxelForge Web Editor ในเบราว์เซอร์ (Three.js 3D view). Bridge sync อัตโนมัติผ่าน WebSocket — แก้ใน editor หรือผ่าน MCP ได้ทั้งคู่
Inputs: no named parameters. Returns: result
voxelforge_list_scenesB
รายชื่อ scene ใน session และไฟล์ที่เซฟ.
Inputs: no named parameters. Returns: result
voxelforge_loadC
โหลด scene จากไฟล์.
Inputs: name (required). Returns: result
voxelforge_merge_statsC
ดูว่ารวม voxel เป็นกล่องแล้วลด part/mesh ได้เท่าไร (ก่อน export).
Inputs: scene_name. Returns: result
voxelforge_place_blockC
วาง voxel 1 ลูกที่พิกัด (x,y,z).
Inputs: x (required), y (required), z (required), color, +1 more. Returns: result
voxelforge_place_manyC
วางหลาย voxel จาก JSON array. รูปแบบ: [[x,y,z,"1"], [1,0,0,"2"], ...] หรือใช้ #RRGGBB เป็นสี
Inputs: blocks_json (required), scene_name. Returns: result
voxelforge_previewC
แสดงสรุป + มุมมอง ASCII แต่ละชั้น Y (ให้ AI ตรวจรูปทรง).
Inputs: scene_name. Returns: result
voxelforge_remove_blockC
ลบ voxel ที่พิกัด.
Inputs: x (required), y (required), z (required), scene_name. Returns: result
voxelforge_saveC
บันทึก scene ลง ~/.voxel-forge/scenes/.
Inputs: scene_name. Returns: result
voxelforge_select_sceneD
เลือก scene ที่กำลังแก้ไข.
Inputs: name (required). Returns: result
voxelforge_set_active_layerC
ตั้ง layer ที่ใช้งาน (index เริ่ม 0).
Inputs: index (required), scene_name. Returns: result
voxelforge_set_paletteC
กำหนดสีในพาเลต (24-bit RGB).
Inputs: b (required), g (required), r (required), color_key (required), +1 more. Returns: result
voxelforge_set_voxel_sizeC
ตั้งขนาด voxel ใน world (1.0=ปกติ, 0.25=ละเอียด 4 เท่า).
Inputs: size (required), scene_name. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 27 tools
Most tools have clearly distinct purposes, such as building specific shapes (build_chibi_bear, build_tree) versus general editing (place_block, remove_block). The only minor overlap is between export_obj and export_obj_legacy, but they are differentiated by legacy status.
All tools follow a consistent 'voxelforge_' prefix with verb_noun pattern (e.g., add_layer, export_obj, create_scene). No mixing of conventions, making the set predictable for an agent.
With 27 tools, the server is slightly on the heavy side but still reasonable for a full-featured voxel editor. Each tool serves a clear function within the domain, and the count reflects comprehensive coverage without being bloated.
The tool set covers core voxel operations: creation, editing, import/export, scene management, and procedural generation. Minor gaps like undo/redo or direct color modification of placed voxels exist, but the surface is largely complete for typical workflows.
Maintenance
Related MCP Connectors
Create, edit, render, save, and export voxel models with interactive 3D previews.
Minecraft builds and skins made by your AI agent, live in your browser tab. Export .schem.
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
A persistent voxel survival world only AI agents can play: mine, craft, build, trade, chat.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables creating, modifying, and managing MagicaVoxel .vox files through natural language, with tools for shape generation, patterns, color operations, and optional ML-powered suggestions.33MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to collaboratively build and edit voxel structures in a shared browser-based arena, using WebMCP tools to place, query, transform, and undo block edits in real-time.MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to create complete, Teardown-ready multi-part .vox voxel models with material palette compatibility, previews, manifests, and XML skeletons so they can write coherent mod files.221MIT
- AlicenseAqualityCmaintenanceEnables MCP clients to create, edit, preview, validate, save, and export voxel models, either on files or by live-editing the scene open in a running voxel editor. Provides drawing primitives, region recoloring, layer management, undo, PNG previews, and exports to formats such as .gox, .vox, OBJ, and glTF.17GPL 3.0