蓝湖设计 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 导入。
工具
使用规范
- 调用方应将返回的签名资源 URL 下载到本地项目,不要生成对远程 Lanhu 签名 URL 的长期依赖。
- 不得在日志、异常或 MCP 响应中记录或输出凭据信息。
- 登出必须调用
lanhu_auth_logout并传confirm=true,或 CLI--confirm,仅删除托管的标记 Profile。 - 托管 Chrome Profile 仅存在于本地;认证凭据从不通过 MCP 网络传输。
常见错误
开发验证
git clone https://github.com/blantian/lanhu-design-mcp
cd lanhu-design-mcp
uv sync --dev
uv run pytest
许可证
MIT