Lanhu Design Mcp

io.github.blantian由 GitHub 帳號 blantian 發布v0.2.0更新於 Oct 24, 2026

Read Lanhu design specs and export fine-grained UI assets with platform-adjusted units

已驗證STDIO僅桌面開發者工具媒體與設計

概覽

AI 產生的概覽

僅支援 macOS 的 MCP 伺服器，讓助理讀取藍湖設計專案、分析設計稿並產生依平台調整的 UI 結構，匯出細緻 UI 資源

可以做什麼
列出藍湖專案中的所有設計圖並取得詳情，支援以 ID 或 URL 查詢、篩選與分頁，並提供不連網、不暴露憑證的本機設定健康檢查。分析指定設計稿，回傳依目標平台調整後的 UI 結構（Android dp、iOS pt、Web px、微信 rpx）。回傳完整設計圖以及 Sketch、Figma、Photoshop 的細緻可下載切圖資源，含多倍率位址。匯出包含資產與分析結果的完整 Agent UI 還原脈絡。透過專屬託管 Chrome Profile 管理認證：互動式登入、查詢狀態、登出並刪除託管 Profile。
適用情境
適合把藍湖設計稿轉成前端或行動端 UI 程式碼時使用：讓助理直接讀取設計、取得依平台調整後的尺寸，並拉取切圖資源。適合已在藍湖協作、希望省去手動複製 Cookie 或逐一張下載切圖的 macOS 使用者。
執行需求
僅支援 macOS；需已安裝 Google Chrome；需 Python 3.10 以上；從 PyPI 安裝 lanhu-design-mcp 並以本機 stdio 程序執行。需要藍湖帳號，透過本機專屬 Chrome Profile 完成一次互動式登入；不支援以 Cookie 環境變數或 Cookie 檔案設定憑證。需具備 Playwright Python 函式庫與 Chrome。
安裝前請注意
首次執行會開啟可見的 Chrome 視窗進行藍湖互動式登入；託管 Profile 僅存於本機，憑證不經 MCP 傳輸，但不再使用時應以 confirm=true 登出並刪除。回傳的資源 URL 為簽章臨時位址，應下載到本機專案，不要長期依賴。設計資料來自藍湖遠端服務，需要網路存取。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Lanhu Design Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

蓝湖设计 MCP

项目简介

面向 macOS 的蓝湖设计读取与细粒度 UI 资源导出 MCP 服务器。

功能

  • 读取蓝湖设计项目，列出所有设计图
  • 分析设计稿并返回平台调整后的 UI 结构（Android dp / iOS pt / Web px / 微信 rpx）
  • 返回完整设计图与 Sketch、Figma、Photoshop 细粒度切图资源及多倍率地址
  • 导出包含资产和分析的完整 Agent UI 还原上下文
  • 托管 Chrome Profile 自动登录，无需手动复制 Cookie

系统要求

  • macOS
  • Google Chrome（已安装）
  • Python 3.10 及以上

安装

bash
pip install lanhu-design-mcp

首次登录

bash
lanhu-design-mcp auth loginlanhu-design-mcp auth status

首次运行打开独立的本地 Chrome Profile，完成一次交互式 Lanhu 登录。后续 MCP 进程自动重用会话，正常设计工具调用不会打开可见浏览器。认证仅使用托管 Chrome Profile，不需要也不支持通过 Cookie 环境变量或 Cookie 文件配置凭据。

bash
lanhu-design-mcp auth logout --confirm

MCP 配置

json
{  "mcpServers": {    "lanhu-design-mcp": {      "type": "stdio",      "command": "/Users/your-name/.local/bin/lanhu-design-mcp",      "args": []    }  }}

将 /Users/your-name 替换为你的本机用户名。此配置适用于 cc-switch 导入。

工具

工具说明
lanhu_health_check返回本地配置状态，不访问网络且不暴露凭据
lanhu_get_designs获取项目的所有设计图列表
lanhu_analyze_design分析指定设计稿并返回平台调整后的 UI 结构
lanhu_get_design_assets返回完整设计图与细粒度可下载切图资源
lanhu_export_ui_context返回包含资产和分析的完整 Agent UI 还原上下文
lanhu_auth_login打开专属 Chrome Profile 进行交互式 Lanhu 登录
lanhu_auth_status报告托管认证状态，不含凭据
lanhu_auth_logout登出并删除托管 Profile，需要 confirm=true

使用规范

  • 调用方应将返回的签名资源 URL 下载到本地项目，不要生成对远程 Lanhu 签名 URL 的长期依赖。
  • 不得在日志、异常或 MCP 响应中记录或输出凭据信息。
  • 登出必须调用 lanhu_auth_logout 并传 confirm=true，或 CLI --confirm，仅删除托管的标记 Profile。
  • 托管 Chrome Profile 仅存在于本地；认证凭据从不通过 MCP 网络传输。

常见错误

状态说明处理
auth_required凭据无效或过期运行 lanhu-design-mcp auth login
unsupported_platform仅在 macOS 支持使用 macOS 设备
dependency_missingPlaywright Python 库或 Chrome 不可用pip install --upgrade lanhu-design-mcp
profile_locked托管 Profile 被其他进程占用等待完成后重试
cancelled登录窗口在认证完成前关闭重新运行 lanhu-design-mcp auth login
timed_out登录窗口 5 分钟内未完成认证重新运行 lanhu-design-mcp auth login

开发验证

bash
git clone https://github.com/blantian/lanhu-design-mcpcd lanhu-design-mcpuv sync --devuv run pytest

许可证

MIT

來源：README.md，提交 b547d6b

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分