English Français العربية

io.github.blantian/lanhu-design-mcp

Official registry Media and design

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package lanhu-design-mcp
Claude Code 
claude mcp add lanhu-design-mcp -- uvx lanhu-design-mcp==0.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "lanhu-design-mcp": {
            "command": "uvx",
            "args": [
                "lanhu-design-mcp==0.2.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 蓝湖设计 MCP
  2. 项目简介
  3. 功能
  4. 系统要求
  5. 安装
  6. 首次登录
  7. MCP 配置
  8. 工具
  9. 使用规范
  10. 常见错误
  11. 开发验证
  12. 许可证

蓝湖设计 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 及以上

安装

pip install lanhu-design-mcp

首次登录

lanhu-design-mcp auth login
lanhu-design-mcp auth status

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

lanhu-design-mcp auth logout --confirm

MCP 配置

{
  "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

开发验证

git clone https://github.com/blantian/lanhu-design-mcp
cd lanhu-design-mcp
uv sync --dev
uv run pytest

许可证

MIT

Frequently asked questions

What is io.github.blantian/lanhu-design-mcp?

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

How do I install io.github.blantian/lanhu-design-mcp?

It runs on your machine. In Claude Code: claude mcp add lanhu-design-mcp -- uvx lanhu-design-mcp==0.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.blantian/lanhu-design-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.blantian/lanhu-design-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.blantian/lanhu-design-mcp?

It is published by blantian. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.