使用说明

MCP开放刷服务器

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

📋 先决条件

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

🚀 安装

克隆或下载文件
安装 Python 依赖项

pip install -r requirements.txt

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

chmod +x openbrush_mcp_server.py

⚙️ 配置

在Open Brush中启用API

启动Open Brush
在设置中启用HTTP API
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文档
检查返回的错误消息

📖 资源

🔒 安全

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

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

📝 许可证

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

🤝 贡献

请随意：

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