Sketchup MCP

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

SketchupMCP 通過模型上下文協議（MCP）將 Sketchup 連接到 Claude AI，讓 Claude 能夠直接與 Sketchup 進行交互和控制。這一整合支持利用提示輔助進行 3D 建模、場景創建以及對 Sketchup 的操作。

特別感謝 mhyrr/sketchup-mcp 提供的架構。我們對其原生版本（mhyrr/sketchup-mcp）進行了簡體中文化以及部分功能的優化與調整。

🚀 快速開始

SketchupMCP 藉助模型上下文協議（MCP）建立起 Sketchup 與 Claude AI 的連接，實現了 Claude 對 Sketchup 的直接交互與控制。通過該整合，用戶可利用提示高效完成 3D 建模、場景創建等操作。

✨ 主要特性

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

📦 安裝指南

該系統由兩個主要組件組成：

1. Sketchup 擴展：在 Sketchup 內部創建 TCP 服務器來接收並執行命令的擴展。
2. MCP 服務器（sketchup_mcp/server.py）：實現模型上下文協議並連接到 Sketchup 擴展的 Python 服務器。

安裝步驟

1. 下載並安裝 SketchupMCP 擴展。
2. 啟動 Sketchup 並開啟 MCP 服務器：

   pip install uv
   

💻 使用示例

基礎用法

以下是一些示例操作：

• "創建一個帶有屋頂和窗戶的簡單房屋模型"
• "選取所有組件並獲取它們的信息"
• "將選取的組件變成紅色"
• "將選取的組件向上移動 10 個單位"
• "將當前場景導出為 3D 模型"
• "使用 Ruby 代碼創建一個複雜的藝術與工藝櫃"

📚 詳細文檔

疑難排解

• 連線問題：確保 Sketchup 擴展服務器和 MCP 服務器都在運行。
• 命令執行失敗：檢查 Sketchup 的 Ruby 控制檯以查看錯誤訊息。
• 超時錯誤：嘗試簡化請求或將操作拆分為較小的步驟。

🔧 技術細節

通信協議

該系統使用基於 TCP 套接字的簡單 JSON 協議：

• 命令：以 JSON 物件的形式發送，包含 type 和可選的 params。
• 回應：以 JSON 物件的形式返回，包含 status 及 result 或 message。

📄 許可證

本項目採用 MIT 授權許可證。