Sketchup Integration

🚀 SketchupMCP - SketchUp 模型上下文協議集成

SketchupMCP 實現了 SketchUp 與 Claude AI 的連接，藉助 Model Context Protocol (MCP)，Claude 能夠直接與 SketchUp 進行交互並對其加以控制。該集成支持提示輔助的 3D 建模、場景創建與操作，為 3D 設計工作帶來了更多便利。

在此，向 Blender MCP 致敬，感謝其提供的靈感與架構參考。

🚀 快速開始

要使用 SketchupMCP，你需要完成安裝並啟動連接，之後便可與 Claude 集成進行交互。具體步驟如下：

1. 安裝：按照“安裝指南”中的步驟完成 Python 包和 SketchUp 插件的安裝。
2. 啟動連接：在 SketchUp 中啟動服務器，並確保 MCP 服務器也在運行。
3. 與 Claude 集成：將特定配置添加到 Claude 配置中，即可開始使用。

✨ 主要特性

• 雙向通信：通過 TCP 套接字連接，實現 Claude 與 SketchUp 的雙向通信。
• 組件操作：支持在 SketchUp 中創建、修改、刪除和變換組件。
• 材質控制：可以應用和修改材質與顏色。
• 場景信息：能夠獲取當前 SketchUp 場景的詳細信息。
• 選擇處理：可獲取並操作選定的組件。
• Ruby 代碼執行：直接在 SketchUp 中執行任意 Ruby 代碼，實現高級操作。

📦 安裝指南

Python 包管理

我們使用 uv，請運行以下命令進行安裝：

brew install uv

SketchUp 插件

1. 下載或構建最新的 .rbz 文件。
2. 在 SketchUp 中，轉到 Window > 擴展管理器。
3. 點擊 "安裝擴展" 並選擇下載的 .rbz 文件。
4. 重啟 SketchUp。

💻 使用示例

啟動連接

1. 在 SketchUp 中，轉到 Extensions > SketchupMCP > 啟動服務器。
2. 服務器將在默認端口 (9876) 上啟動。
3. 確保 MCP 服務器正在運行。

與 Claude 集成

配置 Claude 使用 MCP 服務器，將以下內容添加到 Claude 配置中：

{
    "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 控臺中的錯誤信息。
• 超時錯誤：嘗試簡化請求或將其分解為更小步驟。

🔧 技術細節

通信協議

系統使用基於 JSON 的簡單協議通過 TCP 套接字進行通信：

• 命令：以 JSON 結構傳輸。
• 響應：包含狀態代碼和消息。
• 數據大小指定：使用 Content-Length 頭指定數據大小。
• 支持的 HTTP 方法：POST, GET, DELETE。

🤝 貢獻指南

歡迎為 SketchupMCP 做出貢獻！請參考 CONTRIBUTING.md 瞭解如何參與。

📄 許可證

此項目受 LICENSE 管理。