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 分