English Français العربية

io.github.blantian/lanhu-design-mcp

السجل الرسمي الوسائط والتصميم

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.blantian/lanhu-design-mcp؟

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

كيف أثبّت io.github.blantian/lanhu-design-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add lanhu-design-mcp -- uvx lanhu-design-mcp==0.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.blantian/lanhu-design-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.blantian/lanhu-design-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.blantian/lanhu-design-mcp؟

ينشره blantian. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.