SketchupMCP - Sketchup 模型上下文协议集成

SketchupMCP 通过模型上下文协议 (MCP) 将 Sketchup 连接到 Claude AI，使 Claude 能够直接与 Sketchup 交互并控制它。这种集成支持在 Sketchup 中进行提示辅助的 3D 建模、场景创建和操作。

特别感谢 Blender MCP 提供的灵感和结构。

功能

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

组件

该系统由两个主要组件组成：

1. Sketchup 扩展：一个 Sketchup 扩展，在 Sketchup 中创建一个 TCP 服务器来接收和执行命令
2. MCP 服务器 (sketchup_mcp/server.py)：一个 Python 服务器，实现模型上下文协议并连接到 Sketchup 扩展

安装

Python 打包

我们正在使用 uv，所以你需要 brew install uv

Sketchup 扩展

1. 下载或构建最新的 .rbz 文件
2. 在 Sketchup 中，转到“窗口”>“扩展管理器”
3. 单击“安装扩展”并选择下载的 .rbz 文件
4. 重新启动 Sketchup

用法

启动连接

1. 在 Sketchup 中，转到“扩展”>“SketchupMCP”>“启动服务器”
2. 服务器将在默认端口 (9876) 上启动
3. 确保 MCP 服务器在您的终端中运行

与 Claude 一起使用

通过将以下内容添加到您的 Claude 配置中，配置 Claude 以使用 MCP 服务器：

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

这将从 PyPI 获取最新版本

连接后，Claude 可以使用以下功能与 Sketchup 交互：

工具

• get_scene_info - 获取有关当前 Sketchup 场景的信息
• get_selected_components - 获取有关当前选定组件的信息
• create_component - 使用指定的参数创建一个新组件
• delete_component - 从场景中删除一个组件
• transform_component - 移动、旋转或缩放一个组件
• set_material - 将材质应用于组件
• export_scene - 将当前场景导出为各种格式
• eval_ruby - 在 SketchUp 中执行任意 Ruby 代码以进行高级操作

示例命令

以下是一些您可以要求 Claude 执行的操作示例：

• "创建一个带有屋顶和窗户的简单房屋模型"
• "选择所有组件并获取它们的信息"
• "将选定的组件变为红色"
• "将选定的组件向上移动 10 个单位"
• "将当前场景导出为 3D 模型"
• "使用 Ruby 代码创建一个复杂的工艺品柜"

故障排除

• 连接问题：确保 Sketchup 扩展服务器和 MCP 服务器都在运行
• 命令失败：检查 Sketchup 中的 Ruby 控制台以获取错误消息
• 超时错误：尝试简化您的请求或将其分解为更小的步骤

技术细节

通信协议

该系统使用基于 TCP 套接字的简单 JSON 协议：

• 命令作为带有 type 和可选 params 的 JSON 对象发送
• 响应是带有 status 和 result 或 message 的 JSON 对象

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT