AI导哈

模型上下文协议客户端与Blender集成套件

一个全面的模型上下文协议（MCP）实现，包含通用客户端和Blender集成工具，支持多LLM集成、实时3D工作流和AI驱动的3D模型生成。

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

使用说明

🌀 MCP客户端和Blender集成套件

全面 模型上下文协议（MCP） 实施特点：

  • A. 通用客户端 可以连接到任何MCP服务器
  • 一个专业 搅拌机集成 AI驱动的实时3D工作流程工具。

🚀 特性

🧠 通用MCP客户端(mcp-client-python)

  • 多LLM支持：与Claude（Anthropic）和Gemini（谷歌）无缝集成
  • FastAPI REST API：外部应用程序的干净HTTP接口
  • 通用MCP兼容性：按照MCP规范连接到任何MCP服务器
  • 对话记录：使用JSON导出自动聊天记录
  • 稳健的错误处理：有详细的日志
  • CORS支持：已准备好进行前端/web集成

🧩 Blender MCP服务器(blender-mcp)

  • 直接搅拌机集成：通过套接字与Blender实时通信
  • 资产库支持:
    • 🌄 PolyHaven：HDRI、纹理和模型
    • 🛒 Sketchfab：下载/导入高质量的3D模型
    • 🧠 Hyper3D罗丹：根据文本或图像提示生成基于AI的3D模型
  • 场景和对象管理：检索详细的对象和场景数据
  • Python代码执行：直接在Blender中运行Python脚本
  • 电脑屏幕截图工具：自动捕获Blender视口
  • 材料系统：通过API将纹理和材质应用于对象

🗂️ 项目结构

📁 MCP Client & Blender Suite/
├── 📁 mcp-client-python/            # Universal MCP Client
│   ├── 📁 api/                      # FastAPI server
│   │   ├── 📄 main.py               # API entry point
│   │   ├── 📄 mcp_client.py         # Core MCP client logic
│   │   └── 📄 .env                  # API keys config
│   └── 📁 front/                    # Optional frontend interface
│
└── 📁 blender-mcp/                 # Blender integration
    ├── 📄 server.py                # Socket server inside Blender
    ├── 📄 addon.py                 # Blender addon (socket comms)
    └── 📁 assets/                  # Static/docs assets

🛠️ 安装和设置

✅ 先决条件

  • python 3.8+
  • 搅拌机 3.0+
  • API密钥用于：
    • 双子座（谷歌）
    • 克劳德（人类学）
    • PolyHaven
    • Sketchfab
    • Hyper3D

⚡ 快速开始

1.克隆存储库

git clone https://github.com/yourusername/mcp-client-blender-suite.git
cd mcp-client-blender-suite
  1. 设置通用MCP客户端
cd mcp-client-python
pip install -r requirements.txt
  1. 将API密钥添加到.env文件
echo "GEMINI_API_KEY=your_gemini_key_here" >> api/.env
echo "ANTHROPIC_API_KEY=your_claude_key_here" >> api/.env
  1. 启动MCP客户端API
cd api
python main.py
# Server will run on http://localhost:8000
  1. 安装Blender插件 打开搅拌机→ 编辑>首选项>附加组件

点击“安装…”并选择addon.py

通过首选项启用插件并启动套接字服务器

🎯 用例 -🎨 3D内容创建：Blender任务的自然语言命令

-📦 资产管理：从PolyHaven、Sketchfab等公司导入资产。

-🧠 人工智能建模：使用文本或图像提示生成3D对象

-⚙️ 工作流自动化：运行Python脚本并自动化重复任务

-📚 教育工具：在人工智能的帮助下学习Blender

-🛠️ 快速原型制作：更快地构建和测试3D概念

🔌 API终点 -MCP客户API（FastAPI） -POST/query--向连接的MCP服务器发送查询

GET/tools--列出可用工具

🧠 AI模型（Claude或Gemini）根据.env配置自动选择

搅拌机MCP工具 获取场景信息和对象数据

在Blender中运行脚本 下载/导入资产 应用材质和纹理 从视口捕获屏幕截图

🤝 贡献 我们欢迎捐款！请查看我们的CONTRIBUTING.md：

-代码风格指南

-测试说明

-问题报告

-拉取请求流程

🙏 致谢 -🌀 MCP规范的模型上下文协议

-🌄 PolyHaven开放式3D资产

-🛒 Sketchfab用于3D模型市场

-🤖 Hyper3D Rodin用于AI 3D模型生成

-🧱 Blender基金会开源3D套件

我从这里参考了MCP工具

-https://modelcontextprotocol.io/quickstart/client -https://github.com/zebbern/claude-code-guide -https://github.com/activepieces/activepieces -https://github.com/ahujasid/blender-mcp

相关 MCP