Read Lanhu design specs and export fine-grained UI assets with platform-adjusted units
面向 macOS 的蓝湖设计读取与细粒度 UI 资源导出 MCP 服务器。
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
{
"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 |
lanhu_auth_logout 并传 confirm=true，或 CLI --confirm，仅删除托管的标记 Profile。| 状态 | 说明 | 处理 |
|---|---|---|
auth_required | 凭据无效或过期 | 运行 lanhu-design-mcp auth login |
unsupported_platform | 仅在 macOS 支持 | 使用 macOS 设备 |
dependency_missing | Playwright 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
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
uvx lanhu-design-mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-blantian-lanhu-design-mcp": {
"command": "uvx",
"args": [
"lanhu-design-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencelanhu-design-mcppypiio.github.blantian/lanhu-design-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.