使用说明
搅拌机+克劳德
使用模型上下文协议（MCP）通过Claude AI用自然语言控制Blender。
这个Flake做什么
将Claude Desktop与Blender集成，以便您可以：
- 通过与Claude交谈创建和修改3D对象
- 通过对话生成场景、灯光和材质
- 在人工智能的帮助下自动化Blender工作流程
先决条件
- 搅拌机 已安装（Flatpak或系统包）
- 尼克斯 启用薄片
快速开始
# 1. Enter the environment
nix develop
# 2. Run setup (first time only)
setup-claude-config
setup-blender-addon
# 3. Launch Claude Desktop (in devshell)
claude-desktop
# 4. Launch Blender (another terminal)
blender
在搅拌机中
- Edit → 偏好设置→ 附加组件
- 搜索 “搅拌机MCP” 并启用它
- 按 N 打开侧边栏
- 点击 搅拌机MCP tab → 联系克劳德
- 克劳德应该有联系，试着提示。
支持的安装
此薄片会自动检测：
- Flatpak搅拌机 （Steam Deck，基于Flatpak的发行版）
- 系统搅拌机 （传统包管理器）
命令
| 命令 | 描述 |
|---|---|
setup-claude-config |
配置克劳德桌面MCP |
setup-blender-addon |
安装Blender插件 |
claude-desktop |
启动克劳德桌面 |
配置路径
| 文件 | 位置 |
|---|---|
| 克劳德配置 | ~/.config/Claude/claude_desktop_config.json |
| 搅拌机插件（系统） | ~/.config/blender/<version>/scripts/addons/ |
| 搅拌机插件（Flatpak） | ~/.var/app/org.blender.Blender/config/blender/<version>/scripts/addons/ |
故障排除
未找到搅拌机
# Check installation
flatpak list | grep Blender # For Flatpak
which blender # For system install
插件未出现
# Reinstall
setup-blender-addon
# Then in Blender: Edit → Preferences → Add-ons → Refresh
连接失败
- 重新启动克劳德桌面
- 在Blender中：单击 “联系克劳德” 再次
- 检查Claude Desktop设置中的连接
Claude Desktop无法启动
# Validate config
cat ~/.config/Claude/claude_desktop_config.json | jq
# Regenerate
setup-claude-config
其他
一次性跑步
nix run github:yourusername/blender-claude-mcp
系统安装
{
inputs.blender-claude.url = "github:yourusername/blender-claude-mcp";
outputs = { self, nixpkgs, blender-claude, ... }: {
environment.systemPackages = [
blender-claude.packages.x86_64-linux.claude-desktop
];
};
}
安装什么
- 克劳德桌面 （MCP使用FHS环境）
- 紫外线 （MCP服务器的Python包管理器）
- Python 3.11 （Blender脚本）
- 搅拌机MCP插件 （从上游下载）
注： Blender本身尚未安装-使用您现有的安装！
运作原理
- 搅拌机MCP插件 在Blender中运行本地服务器
- 克劳德桌面 通过MCP协议连接到它
- uvx搅拌机mcp 充当桥梁
- 克劳德发送命令→ MCP服务器→ Blender Python API
鸣谢
- 搅拌机MCP -悉达多Ahuja
- 克劳德桌面Linux Flake -k3d3
- Anthropic -克劳德·艾
