基本能力
产品定位
SketchUp-MCP 是一个用于 3D 建模和场景创建的 AI 辅助工具,通过 MCP 协议连接 SketchUp 和 Claude AI,实现智能化的建模操作。
核心功能
- 双线通信:通过 TCP 套接字连接 Claude AI 与 SketchUp
- 组件操作:创建、修改、删除和变换组件
- 材质控制:应用和修改材质与颜色
- 场景检查:获取当前 SketchUp 场景的详细信息
- 选取处理:获取并操作已选取的组件
- Ruby 代码执行:在 SketchUp 中直接执行任意 Ruby 代码,进行高级操作
适用场景
- 3D 建模辅助
- 场景创建与优化
- 自动化建模任务
- 教育与培训
工具列表
get_scene_info
- 获取当前 SketchUp 场景信息get_selected_components
- 获取当前选取的组件信息create_component
- 创建新组件并指定参数delete_component
- 从场景中删除组件transform_component
- 移动、旋转或缩放组件set_material
- 为组件应用材质export_scene
- 将当前场景导出为多种格式eval_ruby
- 在 SketchUp 中执行任意 Ruby 代码以进行高级操作
常见问题解答
- 连線问题:确保 SketchUp 扩展服务器和 MCP 服务器都在运行
- 命令执行失败:检查 SketchUp 的 Ruby 控制台以查看错误消息
- 超时错误:尝试简化请求或将操作拆分为较小的步骤
使用教程
使用依赖
安装 uv
来管理 Python 环境:
sh
pip install uv
安装教程
安装 SketchUp 扩展
- 下载或自行构建最新的
.rbz
文件 - 在 SketchUp 中,前往 Window > Extension Manager
- 点击 Install Extension,然后选择下载的
.rbz
文件 - 重新启动 SketchUp
通过 Smithery 安装
bash
npx -y @smithery/cli install @BearNetwork-BRNKC/SketchUp-MCP --client claude
调试方式
- 在 SketchUp 中,前往 Extensions > SketchupMCP > Start Server
- 服务器将默认启动在 9876 端口
- 确保 MCP 服务器已在终端执行
在 Claude 配置中加入以下内容以使用 MCP 服务器:
json
"mcpServers": {
"sketchup": {
"command": "uvx",
"args": [
"sketchup-mcp"
]
}
}