首頁 / MCP 教程

MCP 教學（Claude、Codex、Cursor）

主要來源:docs/mcp.md 相關資訊 / 官方MCP指南官方客戶端設定現在涵蓋了許多助手透過幫助 › 連線 AI 助理...在 app 或SolidCraft-cli mcp setup(阿里斯mcp install) — 包括 Claude Code、Claude Desktop、Codex、Cursor、OpenCode、Gemini、Copilot CLI、Windsurf、Zed 和 VS 程式碼。

在此頁面上 MCP 做什麼 啟動伺服器 快速客戶端設定 應用影象 / Snap CLI 克勞德程式碼 克勞德·Desktop 程式碼 方程式 工具 地方模型 檔案存取 例子會議

什麼是MCP伺服器

SolidCraft-cli mcp代理人執行與工具欄、指令碼和 CLI 相同的引擎命令 - 建立草圖,功能,設定引數,測量,螢幕截圖,出口 STEP/STL, undo/redo - 無需開啟對話。

開始它

# Headless
SolidCraft-cli mcp

# Headless from a design or script
SolidCraft-cli mcp --in part.sc

# Bridged: app listens by default — bare mcp finds it (headless when none runs; --headless forces that)
SolidCraft &
SolidCraft-cli mcp

# Fixed port / second app
SolidCraft --control 7878 &
SolidCraft-cli mcp --connect 127.0.0.1:7878

在 Snap 上安裝 CLI 是SolidCraft.cli應用程式將選擇的埠寫入到control/current.port在其資料資料夾中;--control / SolidCraft_CONTROL_PORT仍然超越。

更喜歡SolidCraft_CONTROL_TOKEN過--token在橋樑 - 命令列args在流程列表(官方檔案)中可見。

最快的客戶端設定

最快的路徑在 app 中:幫助 › 連線 AI 助理...從一個終端(與SolidCraft-cli可用 - 參見下面的 PATH 註釋):

SolidCraft-cli mcp setup            # every client found on this computer
SolidCraft-cli mcp setup --dry-run  # show what it would write, change nothing
SolidCraft-cli mcp setup --client opencode --live

mcp install這是一個 alias formcp setup命令寫作 aSolidCraft伺服器輸入使用全路關於TheSolidCraft-cli它執行了,所以客戶端不需要該二進位制PATH一個客戶端在其配置資料夾已經存在時被計算為已安裝;安裝不會啟動客戶端應用程式。<name>.bak首先,無法讀取的檔案單獨留下來,更新後的後續重新執行只會更新它寫的條目路徑(使用者編輯的條目留在你離開的位置)。--live因此新增SolidCraft-live在埠7878上開啟的應用程式,然後重新啟動客戶端。

自從0.22.1,在正常啟動時,應用程式也可以自己做到這一點:它新增或更新SolidCraft對於每個安裝的客戶端(Claude Desktop 和 Claude Code、Codex、OpenCode、Gemini CLI、Copilot CLI、Cursor、VS Code、Windsurf 和 Zed)的 MCP 輸入,並簡短地報告其連線的內容。設定 › 助手 › 使 SolidCraft 可用於此計算機上的 AI 應用程式此分類上一篇: 自動執行(--control或SolidCraft_CONTROL_PORT) 讓您的客戶獨自一人 幫助 › 連線 AI 助理... 和SolidCraft-cli mcp setup當您想自行配置客戶端時,請保持明確的路徑;如果您不禁用,啟動時自動連線是補充的。

支援--client價值觀和他們寫的地方:

--client配置檔案
opencode~/.config/opencode/opencode.json(或.jsonc)
claude-desktop%APPDATA%\Claude\claude_desktop_config.json, ~/Library/Application Support/Claude/, ~/.config/Claude/,以及 Microsoft Store 包資料夾
claude-code~/.claude.json(使用者範圍)mcpServers)
cursor~/.cursor/mcp.json
codex$CODEX_HOME或~/.codex, config.toml(CLI, IDE 擴充套件,桌面)
gemini~/.gemini/settings.json
copilot~/.copilot/mcp-config.json(使用GitHub Copilot CLI)
windsurf~/.codeium/windsurf/mcp_config.json
zed西德settings.json (context_servers)
vscode程式碼使用者mcp.json

OpenCode、Gemini、Copilot CLI、Windsurf、Zed 和 VS 程式碼可以使用相同的程式碼。mcp setup --client …手動OpenCode輸入格式(手動編輯時):

{
  "mcp": {
    "SolidCraft": { "type": "local", "command": ["/path/to/SolidCraft-cli", "mcp"], "enabled": true }
  }
}

使用AppImage、Snap 或 Flatpak? 獲取SolidCraft-cli對於MCP

大多數包裝SolidCraft-cli是PATH自 0.22.1 覆蓋 Windows 安裝程式資料夾以來,macOS 應用程式(連結到/opt/homebrew/bin或/usr/local/bin)和AppImage(小發射器在~/.local/bin在第一個執行時),加上 deb/rpm/FreeBSD/usr/bin《Homebrew Cask. Two Stay Away》PATH設計:Snap ExposesSolidCraft.cli飛行員跑步flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft使用這些作為客戶的command與mcpAppImage 輸入點仍然是 GUI;提取SolidCraft-clifrom the squashfs remains a valid alternate. 已驗證的步驟和客戶端配置:

AppImage CLI 和 MCP 指南

克勞德程式碼

從官方MCPdoc:

claude mcp add SolidCraft -- SolidCraft-cli mcp

或專案.mcp.json:

{
  "mcpServers": {
    "SolidCraft": { "command": "SolidCraft-cli", "args": ["mcp"] }
  }
}

克勞德·桌面(Bridged)

使用控制通道和預設的 MCP (0.21.0+,在 0.30.0 中重置),將應用程式正常啟動,然後指向 Claude Desktop。mcp(它會找到正在執行的應用程式)。在安裝正常程式後,SolidCraft-cli通常在PATH自 0.22.1 (Windows 安裝程式; macOS 應用程式; AppImage~/.local/bin初次執行後發射器;加上 deb/rpm/FreeBSD 和 Homebrew) - 重新啟動客戶端,以便接收新的PATH如果終端無法找到它(典型的舊 Windows 安裝程式),請透過完整的路徑,例如C:\Program Files\SolidCraft\SolidCraft-cli.exe用於SnapSolidCraft.cli用於使用Flatpakflatpak與 Argsrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp(或設定)command/args官方固定埠示例claude_desktop_config.json當您命名一個埠時,它仍然工作:

{
  "mcpServers": {
    "SolidCraft": {
      "command": "/path/to/SolidCraft-cli",
      "args": ["mcp"]
    }
  }
}

對於固定港口:args: ["mcp", "--connect", "127.0.0.1:7878"]然後開始應用程式與SolidCraft --control 7878.

Codex(CLI、IDE擴充套件、桌面應用)

程式碼得到支援SolidCraft-cli mcp setup --client codex(配置下)$CODEX_HOME或~/.codex, config.toml)你也可以跟隨OpenAI 程式碼 MCP 文件: Codex 將 MCP 伺服器儲存在~/.codex/config.toml(或一個專案).codex/config.toml在值得信賴的專案中),由Codex CLI、IDE擴充套件和桌面應用共享。

用一個命令新增無頭伺服器:

codex mcp add SolidCraft -- SolidCraft-cli mcp
codex mcp list     # check it is registered

或 Edit~/.codex/config.toml手動,例如將橋樑連線到正在執行的應用程式並允許設計資料夾:

[mcp_servers.solidcraft]
command = "SolidCraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absolute/path/to/your/designs"]

在 Codex 終端 UI 中,/mcp顯示活躍的伺服器. 使用到二進位制的完整路徑,如果SolidCraft-cli不是在路邊(Snap:SolidCraft.cli• 平板:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft標籤: 第一發射器~/.local/bin或者看CLI 居住的地方單獨,SolidCraft的內部應用程式特工聊天面板可以透過Codex執行npm install -g @agentclientprotocol/codex-acp(官方檔案)

方程式

Cursor 得到支援SolidCraft-cli mcp setup --client cursor(寫作)~/.cursor/mcp.json)下面的手動配置格式如下課程文件 (.cursor/mcp.json或~/.cursor/mcp.json) 設定或手動編輯後,重新載入並確認工具出現在 Cursor 的 MCP 設定中。

{
  "mcpServers": {
    "SolidCraft": {
      "type": "stdio",
      "command": "SolidCraft-cli",
      "args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
    }
  }
}

使用完整的二進位制路徑,如果 Cursor 無法找到SolidCraft-cli上一篇: 為了Snap:SolidCraft.cli對於Flatpak來說:flatpak與run --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

工具(來自官方檔案)

工具角色
list_commands命令目錄
describe_command一個命令的引數文件; JSON 對其輸入和結果的方案,其中命令有一個輸入合同(只讀)
execute / batch執行模型命令;batch可以回滾錯誤和報告rolled_back, undone, applied和not_run可選coalesce_parameters(預設錯誤) 將連續的平行引數編輯合併,以便設計每執行一次重建(一個 undo 步驟;每個步驟保持一個coalesced行程長度)。timings: true新增每步和總毫秒;profile: true新增 kernel boolean / tessellate / 其他分裂,如果應用程式支援它;verbose: false大型設計響應更小一些工具可能被命名為步驟;screenshot, body_topology, batch, pending, running和skill_reference不能,也不能component.edit_in_place或component.finish_edit(單獨送他們去。execute一批在傳送任何東西之前也失敗,當一個步驟在其轉變時肯定會被拒絕(#5853):沒有命令的步驟,未知的命令ID(錯誤命名最接近的ID),或 - 與--param-check strict一個無頭的會話會自行檢查這一點;當橋接時,在接收批次時,在請求自身水平上檢查的應用程式會對其自己的命令進行檢查(伺服器透過連線請求一次)。control.capabilities / param_check);一個較舊的應用程式在傳送之前在伺服器上對伺服器的合同進行檢查(在strict,沒有任何違反合同的內容被髮送)
inspect_design / measure / body_topology閱讀地理和時間線;inspect_design還列出了大會的組合(關閉與joints: false)
set_parameter建立/更改引數和重新計算
screenshot模型或視窗的 PNG
exportSTEP、3MF、STL、OBJ、URDF等。
open / save / new_design文件生命週期
undo / redo歷史
crash_reports列出此計算機的故障報告,或按ID開啟一個(backtrace和最近的命令)
skill_reference讀一讀《知識分子》SolidCraft-modeling, SolidCraft-mechanisms, SolidCraft-editing, SolidCraft-checking, SolidCraft-reporting(二)可選file(缺點)reference.md只讀;當檔案工具關閉時使用代理聊天(自 0.21.0 以來)
running顯示應用在每個連線客戶端(沒有引數)中忙碌或排隊的內容;即使在應用程式忙碌時也響應,因此在重新傳送更改之前在時間關閉後檢查它(自 0.18.3 )
pending橋樑模式:經過長時間的控制請求返回“仍在執行”,等待最多60秒以獲得該結果(done: false當他奔跑的時候,pending: null只有等待,只有等待。running, skill_reference和crash_reports

長期的請求(橋樑):伺服器可以在緩慢的控制呼叫中阻止長達 300 秒;設定 MCP 客戶端時間超過 330 秒 如果呼叫時間過期或返回“仍在執行”,不要重發相同的更改 - 呼叫pending或/或running(或inspect_design)第一。

代理可以設定相同的視角確認控制透過ui.prefs鑰匙view_confirm_corner(缺陷是假的)

首選 › 導航 › 3D 滑鼠在此計算機上的裝置應用程式橋,代理人可以設定ui.prefs鑰匙nav_bridge_enabled(預設錯誤)和nav_bridge_port第875章 來源:docs / 3d 滑鼠.md和印刷 Docs.

代理可以設定偏好 › 導航正確拖動軌道透過ui.prefs鑰匙right_drag_orbits(預設為 true; false 將相機單獨留在右拖動上,滑鼠預設則會軌道)。印刷 Docs.

代理可以透過 Zoom-with-key 設定 Preferences › Navigation trackpadui.prefs鑰匙trackpad_zoom_modifier (off故障;cmd, alt,或ctrl— 單獨保持這個金鑰,這樣垂直的雙手指滾動縮放)。印刷 Docs.

代理人可以透過設定 Preferences › Design Assembly Moveui.prefs鑰匙assembly_move_handles(預設為 true; false 保持前面移動面板),joint_rotation_coarse(預設 10°),以及joint_rotation_fine(預設值為 0.1°) 來源:印刷 Docs.

代理和指令碼可以管理相同的偏好 › 一般 › 設定配置檔案透過settings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.export和settings.profile.import(匯出/匯入使用SolidCraft-profile/1檔案格式) 這些是引擎指令execute,不包含在上面的 MCP 協議工具表中。印刷 Docs.

代理人可以透過執行程式檢查開放設計是否發生了變化,而無需重新讀取。document.revision透過execute;答案是{document_id, revision} — revision只有當設計變更時,才會進行進展。document_id標識開啟的文件(一個不同的後new_design或open) 在桌面控制頻道上,客戶端可以撥打control.subscribe一次而不是投票:第一回復匹配document.revision然後 app 會推design.changed每一次事件document_id或revision變更(在值繼續移動時,合併到每秒約10個;拒絕在相同連線上的第二次訂閱 - 請問document.revision目前的位置: 來源:docs/mcp.md 相關資訊和監控協議.md(根據設計)。

圖形限制和模型幾何:對於巧合、、平等、平行、垂直、中點(一個點和一個行或兩個行的中間點),集中、合線和對稱,任何常見的草圖引數可以是模型邊緣。{edge: [x,y,z], body?}或 Vertex{vertex: [x,y,z], body?}SolidCraft 專案先進入草圖;投影列在created來源:docs.solidcraft.io 列印(限制命令引數)。

標籤標籤(solid.extrude):根據索引或點的配置檔案選擇通常由該區域周圍的曲線儲存,以便它們繼續跟隨引數編輯。當參考幾何(例如,草圖所坐面的面部的投影形狀)將繪製的配置檔案劃分為區域時,該繪製的配置檔案的選擇仍然佔有整個繪製的配置檔案。exact_regions: true使每個索引或點選擇都意味著它命名的區域,匹配 Extrude 對話對話傳送的內容。docs.solidcraft.io 列印 (solid.extrude引數)。

引數檢查(自 0.17.0;SolidCraft-cli run自 0.27.0; 橋樑應用程式呼叫自 0.30.0):附加條款 附加條款(describe_command顯示方案)可以檢查當他們被召喚。--param-check off|warn|strict用於無頭腦的 MCP 會話(包括--in寫作,為SolidCraft-cli run,以及 - 自 0.30.0 - 對於連線到正在執行的應用程式的呼叫:off是故意的,沒有改變。warn執行呼叫,但新增警告,如可能錯誤鍵,並strict連線時,伺服器會嚮應用程式詢問應用程式是否在請求的水平上檢查一次。control.capabilities和param_check在監控協議.md) 如果應用程式這樣做,每個電話和batch透過這個級別傳送,應用程式會對其自己的命令進行檢查(因此,較新的應用程式的金鑰不會被較舊的伺服器的合同拒絕)。strict,一個答案沒有說在那個級別上檢查的應用程式是一個錯誤(呼叫可能執行未檢查 - 檢查設計),然後伺服器自行檢查下一個呼叫。strict沒有傳送任何打破一個命令;沒有伺服器合同的命令不被檢查) 使用這樣一個較舊的應用程式,保持伺服器和應用程式在同一版本。joint.inspect透過execute來源:docs/mcp.md 相關資訊.

五個包裝的代理技能生活在下方skills/在 Repo 中:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanisms,和SolidCraft-reporting(將使用者問題轉化為錯誤報告:以新鮮的設計複製,縮小到最小命令指令碼,檢查measure並拍攝螢幕,並先搜尋現有問題)。skill_reference工具(自 0.21.0)返回這些包裝的文件,而不需要磁碟訪問;文件還記錄了包裝的文件。pending和running工具(共20個工具,分開計算 undo/redo)running從 0.24.0 開始,應用中的代理聊天將工具呼叫顯示為簡單的概述(細節只需單擊)。

使用應用內助理的本地模型

桌面助手可以透過在您的計算機上執行的模型來驅動開放的設計奧爾瑪, LM 工作室,或其他 OpenAI 相容的伺服器. 您需要具有原生工具呼叫(在Ollama,尋找一個tools功能)和足夠的VRAM為模型加上其背景. 單靠工具支援不能保證良好的結果。

設定:啟動伺服器並載入模型 → 偏好 › AI › 新增代理... › OpenAI 相容 API → 選擇 Ollama、LM Studio 或自定義 URL → 輸入基礎 URL (例如:http://localhost:11434/v1對於 Ollama)和模型名稱 → 測試,然後新增 → 開啟助手,選擇終端,並設定許可權(Ask / Edits / All)。

哪些模型工作?可用工具的本地模型差異很大. 官方測量結果(標準測試 v1)GitHub 問題 #4851一般來說,在 ~ 8 GB VRAM 類中具有工具功能的較小的模型可以工作;較大的模型通常得分更高。

解決問題(高階別):答案是 JSON 或程式碼,但沒有改變,通常意味著工具呼叫弱 - 嘗試另一個模型從 #4851. HTTP 400 “不支援工具” 意味著選擇一個工具可用的模型。num_ctx慢的答案通常意味著模型正在從VRAM流入CPU - 嘗試一個較小的模型或量化。SolidCraft-cli bench-assistant自 0.23.1 起,助手還會在使用者介面中警告,當一個轉彎結束時不使用 SolidCraft 工具,並且當 Ollama 模型沒有工具支援時。

官方寫作:特工聊天(本地模式)和#4851.

代理人可以訪問哪些檔案

預設情況下,工具只觸控:

伺服器啟動的工作資料夾本身不計數,因此主點檔案如~/.ssh除非你允許他們。

SolidCraft-cli mcp --allow-path ~/designs --allow-path ~/exports

--allow-any-path刪除限制(以前的行為) - 使用小心。

當 asave(或任何其他呼叫) 被拒絕 “此代理可能使用的資料夾之外”,將資料夾新增到 MCP 客戶端的伺服器args與--allow-path(或重現)SolidCraft-cli mcp setup編輯後),然後重新啟動客戶端,代理應該要求您這樣做,而不是透過應用程式的控制埠儲存,該埠忽略了這些資料夾限制。

在橋式模式下,伺服器傳送allow_paths而那些開啟/儲存的資料夾如design_folders每個要求(參見)監控協議.md);應用程式還根據相同的規則新增了恢復資料夾和設計資料夾 - 選擇絕對路徑。docs/mcp.md 相關資訊.

最小模型會議

從官方doc的示例會議的概念流程:

  1. batch一個草圖直角 → 擠出 → 子 → 切斷一個洞
  2. measure面積 / 面積
  3. screenshot與view: "iso"
  4. export進入允許資料夾中的路徑

演示文字:示例 / 演示 / Enclosure_mcp.py在MCP上構建一個封鎖。

也看:CAD MCP 伺服器比較 · 安裝指南 · 例子.