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

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

SketchupMCP 透過模型上下文協議（MCP）將 Sketchup 連接到 Claude AI，使 Claude 能夠直接與 Sketchup 互動和控制。這項整合允許使用提示輔助 3D 建模、場景創建和操作 Sketchup。

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

功能

• 雙向通信：透過 TCP 套接字連接 Claude AI 與 Sketchup
• 組件操作：在 Sketchup 中創建、修改、刪除和變換組件
• 材質控制：應用和修改材質與顏色
• 場景檢查：獲取當前 Sketchup 場景的詳細資訊
• 選取處理：獲取並操作選定的組件
• Ruby 代碼執行：使用 Ruby 語言進行複雜的建模操作

系統結構

概述

SketchupMCP 系統包含以下主要部分：

1. Sketchup 擴展

   • 功能：提供 Sketchup 平台與外部服務器之間的通信橋接。
   • 作用：接收用戶指令並通過 TCP 套接字傳送至伺服器，同時將伺服器回應傳回用戶端。

2. MCP 伺服器

   • 功能：負責處理來自 Sketchup 擴展的請求，並執行相應的操作。
   • 作用：解析指令、執行建模或操作，然後將結果反饋給客戶端。

具體結構

• Sketchup 擴展

  • 安裝步驟：
    1. 下載並安裝 Sketchup。
    2. 啟動軟件後，在擴展庫中安裝 SketchupMCP 插件。
    3. 開啟插件後，根據提示連接至 MCP 伺服器。

• MCP 伺服器

  • 安裝步驟：
    1. 安裝 Python 環境（建議使用最新版本）。
    2. 使用 Git 克隆 SketchupMCP 專案仓库。
    3. 啟動伺服器後，設定 IP 和_ports 遭遇用戶端連線。

安裝指南

Sketchup 擴展安裝

1. 下載並安裝 Sketchup

   • 官網下載地址：Sketchup 官方網站

2. 啟動軟件並安裝擴展

   • 打開 Sketchup。
   • 遞減至 "編輯" 菜單，選擇 "擴展庫"。
   • 在可用的擴展中找到並安裝 SketchupMCP。

3. 啟用插件

   • 安裝完成後，在工具欄中找到 SketchupMCP 圖標。
   • 點擊圖標以啟動插件，並按照提示連接至 MCP 伺服器。

Python 套件安裝

1. 安裝 Python 環境

   • 推荐使用 Anaconda 或 Pyenv 管理多版本環境。

2. 安裝依賴庫

   • 開啟終端，執行命令：

     pip install sketchupmcp
     

3. 啟動伺服器

   • 使用以下命令啟動 MCP 伺服器：

     python -m sketchupmcp.server --host <IP> --port <PORT>
     

   • 調整 <IP> 和 <PORT> 確保與 Sketchup 擴展連線正常。

使用說明

連線設定

1. 啟動伺服器

   • 在終端執行：

     python -m sketchupmcp.server --host localhost --port 8000
     

2. 啟用擴展並連線

   • 打開 Sketchup。
   • 啟用 SketchupMCP 插件，選擇伺服器 IP 和_ports 遭遇伺服器。

操作指令

• 基本命令

  {
    "type": "create_house",
    "params": {
      "roof_type": "gabled",
      "window_count": 4
    }
  }
  

• 選取操作

  {
    "type": "select_components"
  }
  

• 顏色修改

  {
    "type": "change_color",
    "params": {
      "color": "#FF0000"
    }
  }
  

疑難排解

連線問題

1. 伺服器未啟動

   • 檢查伺服器端是否已正確啟動，並顯示待機訊息。

2. 防火牆干擾

   • 確保伺服器端的防火牆允許_tcp_ports 遭遇連線。

3. 網路問題

   • 使用 ping 命令測試伺服器和客戶端之間的網路連通性。

操作失敗

1. 檢查錯誤訊息

   • 查看 Sketchup 的 Ruby 控制台，捕獲並分析錯誤訊息。

2. 重啟服務

   • 有時簡單地重新啟動伺服器和客戶端可以解決瞬間異常。

高級調試

• 日誌記錄

  python -m sketchupmcp.server --log-level DEBUG
  

• 錯誤回溯

  • 確保所有第三方庫已更新至最新版本，以避免潛在的相容性問題。

安全考量

認證機制

1. 用戶身份驗證

   • 採用令牌認證方式，確保只有授權用戶能連線伺服器。

2. 數據加密

   • 使用 SSL/TLS 加密通訊頻道，防止敏感數據被竊取。

常見攻擊防範

1. 防止 DDoS 攻擊

   • 配置限流策略，限制 동시連線數量。

2. 注入攻擊防護

   • 在處理外部指令時，進行充分的輸入過濾和驗證。

常見問題解答

Q1: 如何安裝 SketchupMCP 插件？

A: 按以下步驟操作：

1. 開啟 Sketchup。
2. 進入 "編輯" > "擴展庫"。
3. 安裝 SketchupMCP 插件。

Q2: 伺服器無法啟動，應該怎麼辦？

A:

1. 確保安裝了最新版本的 Python 和依賴庫。
2. 檢查是否有其他程式占用相同的_ports。
3. 查看伺服器啟動日誌，尋找錯誤訊息。

Q3: 如何更改伺服器埠號？

A: 在啟動命令中指定新的_ports 遭遇：

python -m sketchupmcp.server --host localhost --port 8001

Q4: 插件無法連線伺服器，原因有哪些？

A:

1. 伺服器未正確啟動。
2. 確保客戶端和伺服器在同一個網路下。
3. 檢查_ports 是否通暢。

Q5: 如何保護伺服器免受未授權存取？

A:

1. 啟用用戶身份驗證。
2. 使用 SSL 加密連線。
3. 定期更新軟體版本，堵塞安全漏洞。

常見錯誤與解決方案

錯誤訊息	解決方法
伺服器無法啟動	確保依賴庫已安裝， Ports未被占用
插件無法連線	檢查網路設定，確保防火牆允許連線
延遲過長	優化伺服器配置，或移除不必要的模塊

高級主題

群集架構

1. 負載均衡

   • 使用 Nginx 或 HAProxy 分散請求至多台伺服器。

2. 自動擴展

   • 配置彈性雲服務，根據負載自動增減實例數量。

3. 會話管理

   • 使用 Redis 等iddleware 來管理和同步客戶端會話狀態。

性能優化

1. ** Opcode 缓存**

   • 使用 OpCode caches like Redis or Memcached to speed up repetitive operations.

2. 平行處理

   • 利用多線程或多進程模型提升伺服器的處理能力。

3. 資料庫Optimization

   • 確保數據庫索引 optimal，避免 full-table scans.

安全加固

1. 最小權限原則

   • 每個帳戶只授予完成其工作所需的最低級別的權限。

2. 定期安全審查

   • 進行常規的安全AUDITS to identify and mitigate vulnerabilities.

3. 入侵檢測系統

   • 部署 IDS/IPS 系統來監控並阻擋可疑活動。

進階配置

認證方式

1. JWT 認證

   • 使用 JSON Web Token 進行輕量級的用戶身份驗證。

2. OAuth2 整合

   • 將伺服器與第三方授權服務（如 Google、Facebook）整合，提供聯合登入功能。

日誌管理

1. 日荰이터存儲

   • 使用專業的日庫如 ELK Stack (Elasticsearch, Logstash, Kibana) 進行日謁收集、處理和可視化。

2. 日

   • 配置日位儀表板，實時監控伺服器運行狀況，快速定位問題。

监控與告警

1. 性能監控

   • 使用 Prometheus + Grafana 來.monitor server performance metrics.

2. 異常檢測

   • 配置基於機器學習的 anomaly detection systems to detect unusual patterns in traffic.

3. 即時通知

   • 確保在發生問題時能通過多種通訊管道（如電子郵件、SMS）收到 즉시 알림。

常見錯誤碼

錯誤代號	說明
500 Internal Server Error	伺服器內部錯誤，例如程式錯誤或資源不足
401 Unauthorized	欠缺適當的認證信息
403 Forbidden	諮訪被禁止或拒絕
404 Not Found	所請求的資源未找到
502 Bad Gateway	下遊伺服器回應錯誤
503 Service Unavailable	服務臨時不可用，通常因為負載過高或維護中

結論

SketchupMCP 是一款功能強大的插件，能幫助您在 SketchUp 中實現各種複雜的建築設計和模擬。透過合理的配置和最佳實踐，可以充分發揮其潛力，提升工作效율。希望本指南能助您一臂之力，祝您的建模過程順利！

附錄：

• 附錄A: 安裝依賴庫
• 附錄B: 認證機制
• 附錄C: 常用命令與腳本

參考文獻：

1. SketchUp 官方文件
2. 相關技術白皮書
3. 開發團隊內部紀錄

---

註釋： 此指南為示範性質，具體內容可能因版本不同而有所變動。建議使用時參照官方最新文檔。

SketchupMCP 插件用戶手冊

SketchupMCP 是一款功能強大的插件，能幫助您在 SketchUp 中實現各種複雜的建築設計和模擬。本指南旨在為您提供全面的配置和使用建議，讓您充分發揮其潛力。

---

目錄

1. 安裝與配置

   • 1.1 安裝步驟
   • 1.2 環境依賴
   • 1.3 設定初始化

2. 基本使用方法

   • 2.1 插件功能Overview
   • 2.2 快捷鍵與操作指南
   • 2.3 常用命令參考

3. 進階配置

   • 3.1 群集架構
   • 3.2 負載均衡設置
   • 3.3 安全加固措施

4. 錯誤排查與解決方案

   • 4.1 常見錯誤碼
   • 4.2 錯誤診斷步驟
   • 4.3 日誌分析方法

5. 附錄

   • 5.1 安裝依賴庫
   • 5.2 認證機制詳細介紹
   • 5.3 常用命令與腳本示例

---

1. 安裝與配置

1.1 安裝步驟

1. 下載最新版本的 SketchupMCP 插件。
2. 打開 SketchUp 檢查是否有可用更新，然後安裝插件。
3. 開啟 SketchUp，進入 編輯 > 擴展庫 確認插件已正確安裝。

1.2 環境依賴

• 操作系統: Windows 7 及以上版本、MacOS X 10.10 及以上版本。
• SketchUp 版本: 支援 SketchUp 2018 及以上版本。
• Python 確定環境: 確保安裝了 Python 3.6 或更高版本。

1.3 設定初始化

1. 打開 SketchUp，進入 編輯 > 擴展庫。
2. 選擇 SketchupMCP 插件並打開。
3. 根據向導完成初始設置，包括選擇工作目錄和配置基本選項。

---

2. 基本使用方法

2.1 插件功能Overview

SketchupMCP 提供多種功能模塊，包括建築建模、結構分析、能耗計算等，適合專業建築師和設計師使用。

2.2 快捷鍵與操作指南

• 按鈕: 在 SketchUp 的工具欄中找到 SketchupMCP 按鈕，點擊即可啟動插件。
• 快捷鍵: 設置自定義快捷鍵以提高工作效率。

2.3 常用命令參考

# 示例命令
mcp new_project [project_name]  # 新建項目
mcp open [project_path]         # 開啟已存在項目
mcp save                         # 保存當前項目

---

3. 進階配置

3.1 群集架構

• 配置多台伺服器: 在 SketchupMCP 中設置群集模式，分散計算負載。
• 通信協議: 選擇合適的通訊協議（如 HTTP/HTTPS）以確保數據傳輸安全。

3.2 負載均衡設置

• 配置反向代理: 使用 Nginx 或 Apache 等伺服器軟件實現負載均衡。
• **.health check mechanism: 配置健康檢查機制，確保每台伺服器狀態正常。

3.3 安全加固措施

• SSL 証書: 採用 SSL 加密通信，保護數據安全。
• 認證授權: 配置多級用戶權限管理，限制未經授權的訪問。

---

4. 錯誤排查與解決方案

4.1 常見錯誤碼

錯誤代號	說明
500 Internal Server Error	伺服器內部錯誤，例如程式錯誤或資源不足
401 Unauthorized	欠缺適當的認證信息
403 Forbidden	諮訪被禁止或拒絕

4.2 錯誤診斷步驟

1. 檢查日誌文件，查找錯誤代號。
2. 根據錯誤代號對應的原因進行相應的設置調整。

4.3 日方法

• 日位儀表板: 使用 Grafana 等工具來.visualize 日誌數據，快速定位問題。

---

5. 附錄

5.1 安裝依賴庫

pip install -r requirements.txt

5.2 認證機制詳細介紹

• 基本認證: 使用$username:$password 格式進行認證。
• トークンベース認証: 採用令牌方式，增加安全性。

5.3 常用命令與腳本示例

# 示例腳本
#!/bin/bash
mcp batch_process /path/to/projects/

---

結論

SketchupMCP 是一款功能強大的插件，能幫助您在 SketchUp 中實現各種複雜的建築設計和模擬。透過合理的配置和最佳實踐，可以充分發揮其潛力，提升工作效율。希望本指南能助您一臂之力，祝您的建模過程順利！

附錄：

• 附錄A: 安裝依賴庫
• 附錄B: 認證機制
• 附錄C: 常用命令與腳本

參考文獻：

1. SketchUp 官方文件
2. 相關技術白皮書
3. 開發團隊內部紀錄

---

註釋： 此指南為示範性質，具體內容可能因版本不同而有所變動。建議使用時參照官方最新文檔。