前言¶
在 DeepSeek Harness(DSH)裏做 UI 設計或界面生成時,如果只能手動打開 Google Stitch 網頁、複製結果再貼回對話,助手就無法在項目、屏幕和設計系統之間連貫操作。常見做法是自建 MCP 客戶端、手寫 HTTP 頭或本地再起一層代理進程,配置分散,也不利於和 Harness 裏的其他工具並列使用。
下面介紹社區插件 dsh-stitch-mcp(維護者 oooplz,分類:聯網工具)。它把 Google Stitch 註冊爲 Harness 原生的 mcp__stitch__* 工具,通過 Streamable HTTP 直連 Google 文檔中的遠程 MCP 端點,並在插件面板裏配置 API Key 或 OAuth,可選僅針對 Stitch 出站流量的代理。無本地 helper 進程、無額外監聽端口;網絡由 Harness 進程發起。
這是什麼¶
dsh-stitch-mcp 是 DSH 的 web profile 插件,倉庫:oooplz/dsh-stitch-mcp。目錄頁:SkillHub 插件頁。
Stitch 本身是遠程 MCP 端點。插件按 Google 對 MCP 客戶端的說明,用 HTTP 傳輸並在請求頭裏攜帶憑據,形態與官方示例一致:
{ "servers": { "stitch": {
"type": "http",
"url": "https://stitch.googleapis.com/mcp",
"headers": { "X-Goog-Api-Key": "AQ...." } } } }
Host 側解析憑據後寫入 ~/.dsh/dsh-runtimes/stitch-mcp/config.json,MCP 行在組裝 headers 時同步讀取;因此在面板裏保存憑據會觸發該條目重載,無需重啓 Harness 即可生效。
核心功能¶
遠端暴露 16 個工具,在 Harness 中註冊爲 mcp__stitch__*,用途如下(與 README 工具表一致):
| 工具 | 用途 |
|---|---|
list_projects / get_project / create_project / delete_project |
項目 |
list_screens / get_screen / download_file |
屏幕及其文件 |
generate_screen_from_text / edit_screens / generate_variants |
生成與編輯 UI |
list_design_systems / create_design_system / create_design_system_from_design_md / update_design_system / apply_design_system |
設計系統 |
upload_design_md |
上傳 DESIGN.md |
助手安裝並配置憑據後,可在對話中列出、創建、編輯 Stitch 項目、界面與設計系統,並與 Harness 裏其他 MCP 能力並列使用。
憑據與連通性:
- 面板 Settings → Plugins → Google Stitch:API Key 頁對應
X-Goog-Api-Key;OAuth 頁對應Authorization: Bearer <access token>,可選X-Goog-User-Project綁定項目。 - 密鑰在 stitch.withgoogle.com/settings → API key → Create key 創建;完整密鑰僅展示一次。OAuth 可使用例如
gcloud auth print-access-token的輸出。 - 憑據經 Host 的
credentials服務寫入(面板爲只寫展示:僅顯示是否已配置)。 - Use a proxy 開關:開啓後僅 本插件 對
stitch.googleapis.com的請求走http://<ip>:<port>,Harness 內模型 API、網頁搜索及其他 MCP 保持原路由;數秒內於運行中生效,不寫入~/.dsh/.env。默認直連,能訪問 Google 則無需額外配置。 - 健康與故障信息見
~/.dsh/dsh-runtimes/stitch-mcp/status.json(含endpoint、credential、proxy、route、reachable、tools或error)。
插件包當前在資料中可見版本爲 0.6.2(以 npm 包 package.json 爲準);0.6.0 以下需手動安裝 Google stitch CLI,新機器上易出現 server is disconnected。許可證:MIT。
安裝與啓用¶
在 Harness 使用 web profile 時,安裝命令以 README 爲準(請保留 @latest:Harness 有 minimumReleaseAge,省略後綴可能裝到較舊版本):
dsh plugin --profile web add dsh-stitch-mcp@latest
若啓動 Harness 時使用的不是 web,將 --profile web 換成你的 profile 名稱。
安裝完成後:
- 打開 Settings → Plugins → Google Stitch,粘貼 API Key 或 OAuth token,Save。
- 若無法直連
stitch.googleapis.com,在卡片打開 Use a proxy 並填寫代理地址;仍失敗時查看status.json中的error/proxyError(README 故障表有對照說明)。 - 在對話中讓助手調用
mcp__stitch__*工具(例如list_projects、generate_screen_from_text等)。
典型用法¶
README 未給出固定對話腳本,可復現的路徑是:安裝插件 → 面板保存憑據 → 在會話中描述目標,由助手選擇對應 Stitch 工具。例如:
- 先
list_projects/get_project確認項目上下文; - 用
generate_screen_from_text或edit_screens生成或改界面; - 用
list_design_systems、create_design_system_from_design_md、apply_design_system維護並套用設計系統; - 需要本地文件時用
download_file,或upload_design_md上傳 DESIGN.md。
若工具列表已出現但調用返回 “Request is missing required authentication credential”,說明握手階段不需要密鑰、但調用尚未保存憑據——在卡片粘貼 Key 後保存即可。
適用場景與注意¶
適合誰:已在 DSH 中開發智能體、需要把 Google Stitch 的項目 / 屏幕 / 設計系統能力接進對話,且希望配置集中在 Harness 插件面板、而不是自搭 MCP 轉發或本地 CLI 的用戶。
務必注意:
- 插件以當前 DSH 進程權限運行,會向
https://stitch.googleapis.com/mcp發起 HTTPS 請求;安裝前請自行查看 GitHub 源碼 與 MIT 許可證,確認符合你的安全與合規要求。 - 社區目錄 SkillHub 爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;DSH 生態遵循「一切皆插件」,本介紹描述的是社區維護的聯網工具插件,而非官方應用商店條目。
- 出現
server is disconnected時,多爲進程完全無法連上 Stitch 端點;按 README 給進程配置可達 Google 的代理或網絡策略,必要時重啓 Harness。MCP 行多次重試放棄後,保存憑據可重載條目,重啓 Harness 也會重新拉起客戶端。
結尾¶
dsh-stitch-mcp 把 Google Stitch 以原生 MCP 工具形式接入 DeepSeek Harness:直連官方端點、面板管理 API Key / OAuth、可選僅作用於 Stitch 的代理,並暴露完整的 16 項項目與設計能力。需要細節、故障表與目錄結構說明時,以倉庫 README 爲準。