Open Brush MCP Server

MCP开放刷服务器

此MCP（模型上下文协议）服务器将Open Brush API公开为LLM可通过MCP协议使用的工具。

📋 先决条件

• Python 3.10或更高版本
• 在启用API的情况下运行Open Brush（端口40074）
• 访问MCP客户端（如Claude Desktop）

🚀 安装

1. 克隆或下载文件

1. 安装 Python 依赖项

pip install -r requirements.txt

1. 使脚本可执行（Linux/Mac上可选）

chmod +x openbrush_mcp_server.py

⚙️ 配置

在Open Brush中启用API

1. 启动Open Brush
2. 在设置中启用HTTP API
3. API应在 http://localhost:40074/api/v1

在Claude桌面中配置

将此配置添加到您的Claude Desktop MCP配置文件中：

在macOS上： ~/Library/Application Support/Claude/claude_desktop_config.json

在Windows上： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "openbrush": {
      "command": "python",
      "args": [
        "/path/to/openbrush_mcp_server.py"
      ]
    }
  }
}

替换 /path/to/ 带有文件的绝对路径。

📚 可用工具

服务器公开了许多按类别组织的工具：

🎨 绘图

• draw_paths -绘制多条路径
• draw_path -使用逗号分隔的XYZ三元组绘制一个简单的路径（例如。 [0,0,0],[0,1,0],[1,1,0]，不是SVG）
• draw_stroke -用方向和压力画一个笔划
• draw_polygon -绘制多边形
• draw_text -绘制文本
• draw_svg_path -绘制SVG路径

🖌️ 刷子

• brush_set_type -更改画笔类型
• brush_set_size -设置画笔大小
• brush_add_size -修改画笔大小
• brush_set_path_smoothing -设置平滑
• brush_move -移动画笔（绝对位置）
• brush_translate -移动刷子（相对）
• brush_rotate -旋转刷子（绝对）
• brush_turn -旋转刷子（相对）
• brush_draw -画一条直线

🎨 颜色

• color_set_rgb -设置RGB颜色
• color_set_hsv -在HSV中设置颜色
• color_set_html -使用HTML/CSS设置颜色
• color_add_rgb -修改颜色（RGB）
• color_add_hsv -修改颜色（HSV）

🧊 3D模型

• model_import -导入本地模型
• model_web_import -从URL导入
• model_icosa_import -从Icosa画廊进口
• model_select -选择型号
• model_position -职位模型
• model_rotation -旋转模型
• model_scale -比例模型
• model_delete -删除模型

💾 保存/加载

• save_overwrite -保存（覆盖）
• save_as -另存为。。。
• save_new -新建保存
• load_user -加载用户草图
• load_named -按名称加载
• new_scene -新场景

📷 相机

• camera_move -移动相机（绝对）
• camera_translate -移动相机（相对）
• camera_rotate -旋转相机（绝对）
• camera_turn -旋转相机（相对）
• spectator_move -移动观众视图

✂️ 选择

• selection_select_all -全选
• selection_invert -反转选择
• selection_delete -删除所选内容
• selection_duplicate -重复选择

📑 图层

• layer_create -创建图层
• layer_set -设置活动层
• layer_show -显示图层
• layer_hide -隐藏图层

📐 指南

• guide_add -添加向导（立方体、球体等）
• guide_position -位置指南
• guide_scale -比例指南

🔄 对称

• symmetry_mode -对称模式
• symmetry_position -对称小部件位置

🔧 公用事业

• undo -撤消
• redo -重做
• show_help -显示API帮助

💡 使用示例

在Claude Desktop中配置服务器后，您可以给出自然语言指令：

"Draw a red square of size 2 at position 0,0,0"
"Change brush to 'ink' and set color to blue"
"Create a 6-sided polygon with radius 3"
"Import the model 'Andy.glb' and position it at 1,2,3"
"Save the scene as 'my_creation'"

🔍 测试服务器

要手动测试服务器，请执行以下操作：

python openbrush_mcp_server.py

服务器应根据MCP协议启动stdin/stdout并等待命令。

🛠️ 故障排除

无法访问Open Brush API

• 检查Open Brush是否正在运行
• 检查设置中是否启用了HTTP API
• 手动测试： http://localhost:40074/api/v1?help

MCP服务器未连接

• 检查Claude Desktop配置中的路径
• 检查Python是否在PATH中
• 检查克劳德桌面日志

命令失败

• 检查提供的参数
• 查看Open Brush API文档
• 检查返回的错误消息

📖 资源

• 打开画笔文档
• 模型上下文协议（MCP）
• 完整的Open Brush API （Open Brush运行时）

🔒 安全

⚠️ 警告：此服务器调用本地API。确保：

• 不在互联网上暴露端口40074
• 信任发送的命令
• 定期备份您的创作

📝 许可证

此MCP服务器按原样提供，以方便在LLM中使用Open Brush。

🤝 贡献

请随意：

• 报告错误
• 提出改进建议
• 为缺少的API命令添加新工具

______________________________________________________________________

备注：Open Brush是谷歌Tilt Brush的开源分支。此MCP服务器与Open Brush没有正式关联。