MagicaVoxel MCP服务器
模型上下文协议（MCP）服务器，具有用于程序体素建模、分析、动画和MagicaVoxel集成的广泛工具集。
亮点
- 形状图元、变换、布尔运算、区域复制/粘贴、模型克隆。
- 高级图像摄取：彩色体素化、轮廓挤压、深度图、多视图雕刻、边缘到体素。
- 程序生成器：车辆、家具、武器、结构、生物、自然、安卡拉风格的街区、场馆内部和NPC角色（工作人员/客户）。
- 编辑/图案：渐变、纹理、侵蚀/膨胀、轮廓/平滑/斜面、细节噪波、表面颜色随机化。
- 调色板管理：加载/保存PNG调色板，生成预设，提取/混合/应用调色板。
- 分析和智能工具：测量、对称性、LOD简化、体素文本、自动UV着色。
- 动画助手：帧注册表、插值、精灵表导出、GIF占位符。
- 导入/导出：VOX、OBJ、PLY、STL、glTF 2.0、PNG切片、简单的Minecraft原理图；OBJ/SVG进口商。
需求
- Node.js 18+
- MagicaVoxel.exe（可选，是必需的
open_in_magica)
安装并运行
npm install
npm run build
npm start发展： npm run dev
关键工具（示例）
- 模型管理：
create_model,list_models,clone_model,delete_model,get_model_info - 图元和编辑：
fill_box,fill_sphere,draw_line,transform_translate,rotate_arbitrary,boolean_op,mirror_model,hollow_model,erode,dilate,outline,smooth_model,extrude_face,bevel_edges,add_detail_noise - 图案/渐变：
apply_pattern,apply_gradient,randomize_surface_color - 图片：
image_to_voxel_colorized,image_silhouette_to_3d,edge_detect_to_voxel,depth_map_to_voxel,multi_view_to_voxel - 发电机：
generate_vehicle,generate_furniture,generate_weapon,generate_structure,generate_creature,generate_nature,generate_ankara_block,generate_venue_interior,generate_venue_character,generate_staff,generate_customer - 调色板：
generate_palette,extract_palette_from_image,apply_palette_to_model,blend_palettes,set_palette_index,save_palette_to_png - 分析：
measure_distance,get_surface_area,get_volume,find_center,get_dimensions,count_colors - 动画：
create_animation,add_frame,interpolate_frames,export_animation_spritesheet,export_animation_gif（抛出直到添加编码器） - 进口/出口：
save_vox,load_vox,export_obj,export_ply,export_slices,export_stl,export_gltf,export_minecraft_schematic,import_obj,import_svg - MagicaVoxel集成：
set_magica_path,open_in_magica
用法片段
# Hollow sphere
create_model {sizeX:64, sizeY:64, sizeZ:64}
fill_sphere {id:"1", cx:32, cy:32, cz:32, r:20, i:200}
hollow_model {id:"1", thickness:2}
save_vox {id:"1", path:"out/hollow_sphere.vox"}
# Colorized heightmap
image_to_voxel_colorized {path:"input.png", sizeX:128, sizeY:128, sizeZ:64, mode:"heightmap"}
apply_gradient {id:"1", axis:"z", i0:100, i1:200}
# Night venue setup
generate_ankara_block {sizeX:180, sizeY:180, sizeZ:48}
create_model {sizeX:64, sizeY:64, sizeZ:32}
generate_venue_interior {id:"2"}备注
- 调色板：256种颜色（索引0=空）。默认调色板为灰度。
- 坐标：X=右，Y=前，Z=上。
- 演出
deduplicate_voxels在繁重的行动后有所帮助。 - GIF导出当前抛出；spritesheet PNG可用。
- Minecraft导出使用简单的JSON原理图（不是NBT）。
客户端集成（克劳德桌面）
使用 client-config/claude-desktop.json 作为模板；与...一起建设 npm run build 然后跑 node dist/index.js 从repo根目录。