SketchupMCP - Sketchup 模型上下文協議（MCP）整合

基本能力

产品定位

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 环境：

pip install uv

安装教程

安装 SketchUp 扩展

1. 下载或自行构建最新的 .rbz 文件
2. 在 SketchUp 中，前往 Window > Extension Manager
3. 点击 Install Extension，然后选择下载的 .rbz 文件
4. 重新启动 SketchUp

通过 Smithery 安装

npx -y @smithery/cli install @BearNetwork-BRNKC/SketchUp-MCP --client claude

调试方式

1. 在 SketchUp 中，前往 Extensions > SketchupMCP > Start Server
2. 服务器将默认启动在 9876 端口
3. 确保 MCP 服务器已在终端执行

在 Claude 配置中加入以下内容以使用 MCP 服务器：

"mcpServers": {
    "sketchup": {
        "command": "uvx",
        "args": [
            "sketchup-mcp"
        ]
    }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。