AI导哈

Blender MCP Java移植

将Blender Open MCP项目的核心功能移植到Java环境，同时保持与Blender Python插件的兼容性。

  • by akrios-d
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 akrios-d/blender-mcp

使用说明

Blender MCP（Java端口）

此存储库是 基于Java的端口 最初的Blender Open MCP项目 达卡尼拉詹该项目的目标是将MCP系统的核心功能引入Java环境，同时使用Spring AI保持与现有Blender插件结构的兼容性。

📦 项目概述

该项目将原始MCP实现的主要逻辑和功能移植到Java中。它保留了原件 addon.py 从源代码库中删除文件，以确保与Blender基于Python的附加组件架构兼容。

🔧 已移植的内容

  • 用Java重写核心MCP逻辑
  • 重构以提高结构和可读性
  • 集成层允许Java逻辑与现有的Python插件一起使用

🧩 原始回购还剩下什么

  • dhakalnirajan.py 仍按原样使用

📁 存储库结构

b l e n d e r - m c p /
├── java/                  # Ported Java source code
├── addon/                 # Python add-on structure
│   └── dhakalnirajan.py           # Original add-on file retained
└── resources/             # Any additional assets

🚀 入门指南

需求

  • Java 17+ （或您的目标版本）
  • 搅拌机3.x+
  • Blender附带的Python环境

安装

  1. 克隆存储库：

    git clone https://github.com/akrios-d/blender-mcp

  2. 根据需要构建或运行Java模块。

  3. 通过加载包含以下内容的文件夹来安装Blender插件 dhakalnirajan.py.

🧪 用法

安装Blender插件：

  • 打开搅拌机。
  • 首选 Edit -> Preferences -> Add-ons.
  • 点击 Install....
  • 选择 dhakalnirajan.py 文件来自 addon 目录。
  • 启用“Blender MCP”插件。

启动Blender插件服务器：

  • 打开Blender和3D视口。
  • 按 N 打开侧边栏。
  • 找到“搅拌机MCP”面板。
  • 点击“启动MCP服务器”。

🤝 致谢

特别感谢 达卡尼拉詹 对于最初的Blender Open MCP实现。

原始存储库： https://github.com/dhakalnirajan/blender-open-mcp/tree/main

向代理发送提示

您可以使用自然语言指导Blender。例子：

curl -X POST http://localhost:8080/api/agent/run \
  -H "Content-Type: application/json" \
  -d '{"prompt": "create a red cube and render it"}'

预期示例输出：

Created object: Cube
Applied material: Red
Rendered image (Base64): <...>

今天什么有效

工具名称 描述 参数
get_scene_info 检索场景详细信息。 无
get_object_info 检索有关对象的信息。 object_name （str）
create_object 创建三维对象。 type, name, location, rotation, scale
modify_object 修改对象的属性。 name, location, rotation, scale, visible
delete_object 删除对象。 name （str）
set_material 将材质指定给对象。 object_name, material_name, color
render_image 渲染图像。 file_path （str）
execute_blender_code 在Blender中执行Python代码。 code （str）
get_polyhaven_categories 列出PolyHaven资产类别。 asset_type （str）
search_polyhaven_assets 搜索PolyHaven资产。 asset_type, categories
download_polyhaven_asset 下载PolyHaven资产。 asset_id, asset_type, resolution, file_format
set_texture 应用下载的纹理。 object_name, texture_id
set_ollama_model 设置Ollama模型。 model_name （str）
set_ollama_url 设置Ollama服务器URL url （str）
get_ollama_models 列出可用的Olama型号。 无

🔮 未来工作

项目前进方向的路线图。

1.转换为完整的Spring MCP服务器

从当前基于REST的工作流转移到真正的MCP服务器：

  • 正确的MCP工具
  • 标准邮件信封
  • 更清晰的功能式交互

2.与 ahujasid/blender-mcp

存储库：

https://github.com/ahujasid/blender-mcp

相关 MCP