SketchupMCP - Sketchup Model Context Protocol Integration - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

SketchupMCP 是一个用于 3D 建模和场景创建的 AI 辅助工具，通过集成 Claude AI 和 Sketchup，提供智能化的建模体验。

核心功能

• 双向通信：通过 TCP 套接字连接实现 Claude AI 与 Sketchup 的交互。
• 组件操作：创建、修改、删除和变换 Sketchup 中的组件。
• 材质控制：应用和修改材质及颜色。
• 场景检查：获取当前 Sketchup 场景的详细信息。
• 选择处理：获取和操作选中的组件。
• Ruby 代码评估：在 Sketchup 中直接执行任意 Ruby 代码以进行高级操作。

适用场景

• 通过 AI 提示辅助进行 3D 建模。
• 自动化创建和修改复杂场景。
• 快速生成和导出 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：
  bash
brew install uv

安装教程

1. Sketchup 扩展安装：
2. 下载或构建最新的 .rbz 文件。
3. 在 Sketchup 中，转到 Window > Extension Manager。
4. 点击 "Install Extension" 并选择下载的 .rbz 文件。

5. 重启 Sketchup。

6. MCP 服务器安装：

7. 确保 Python 环境已安装。
8. 通过 PyPI 安装 sketchup-mcp：
   bash
pip install sketchup-mcp

调试方式

1. 启动连接：
2. 在 Sketchup 中，转到 Extensions > SketchupMCP > Start Server。
3. 服务器将在默认端口 (9876) 上启动。

4. 确保 MCP 服务器在终端中运行。

5. 配置 Claude：

6. 在 Claude 配置中添加以下内容：
   json
"mcpServers": {
"sketchup": {
"command": "uvx",
"args": [
"sketchup-mcp"
]
}
}

7. 验证连接：

8. 在 Sketchup 中执行简单命令（如 get_scene_info）以验证连接是否正常。
9. 检查终端和 Sketchup 的 Ruby 控制台以查看是否有错误消息。