{
  "markdown": "<!-- mcp-name: io.github.blantian/lanhu-design-mcp -->\n\n# 蓝湖设计 MCP\n\n## 项目简介\n\n面向 macOS 的蓝湖设计读取与细粒度 UI 资源导出 MCP 服务器。\n\n## 功能\n\n- 读取蓝湖设计项目，列出所有设计图\n- 分析设计稿并返回平台调整后的 UI 结构（Android dp / iOS pt / Web px / 微信 rpx）\n- 返回完整设计图与 Sketch、Figma、Photoshop 细粒度切图资源及多倍率地址\n- 导出包含资产和分析的完整 Agent UI 还原上下文\n- 托管 Chrome Profile 自动登录，无需手动复制 Cookie\n\n## 系统要求\n\n- macOS\n- Google Chrome（已安装）\n- Python 3.10 及以上\n\n## 安装\n\n```bash\npip install lanhu-design-mcp\n```\n\n## 首次登录\n\n```bash\nlanhu-design-mcp auth login\nlanhu-design-mcp auth status\n```\n\n首次运行打开独立的本地 Chrome Profile，完成一次交互式 Lanhu 登录。后续 MCP 进程自动重用会话，正常设计工具调用不会打开可见浏览器。认证仅使用托管 Chrome Profile，不需要也不支持通过 Cookie 环境变量或 Cookie 文件配置凭据。\n\n```bash\nlanhu-design-mcp auth logout --confirm\n```\n\n## MCP 配置\n\n```json\n{\n  \"mcpServers\": {\n    \"lanhu-design-mcp\": {\n      \"type\": \"stdio\",\n      \"command\": \"/Users/your-name/.local/bin/lanhu-design-mcp\",\n      \"args\": []\n    }\n  }\n}\n```\n\n将 `/Users/your-name` 替换为你的本机用户名。此配置适用于 cc-switch 导入。\n\n## 工具\n\n| 工具 | 说明 |\n|---|---|\n| `lanhu_health_check` | 返回本地配置状态，不访问网络且不暴露凭据 |\n| `lanhu_get_designs` | 获取项目的所有设计图列表 |\n| `lanhu_analyze_design` | 分析指定设计稿并返回平台调整后的 UI 结构 |\n| `lanhu_get_design_assets` | 返回完整设计图与细粒度可下载切图资源 |\n| `lanhu_export_ui_context` | 返回包含资产和分析的完整 Agent UI 还原上下文 |\n| `lanhu_auth_login` | 打开专属 Chrome Profile 进行交互式 Lanhu 登录 |\n| `lanhu_auth_status` | 报告托管认证状态，不含凭据 |\n| `lanhu_auth_logout` | 登出并删除托管 Profile，需要 confirm=true |\n\n## 使用规范\n\n- 调用方应将返回的签名资源 URL 下载到本地项目，不要生成对远程 Lanhu 签名 URL 的长期依赖。\n- 不得在日志、异常或 MCP 响应中记录或输出凭据信息。\n- 登出必须调用 `lanhu_auth_logout` 并传 `confirm=true`，或 CLI `--confirm`，仅删除托管的标记 Profile。\n- 托管 Chrome Profile 仅存在于本地；认证凭据从不通过 MCP 网络传输。\n\n## 常见错误\n\n| 状态 | 说明 | 处理 |\n|---|---|---|\n| `auth_required` | 凭据无效或过期 | 运行 `lanhu-design-mcp auth login` |\n| `unsupported_platform` | 仅在 macOS 支持 | 使用 macOS 设备 |\n| `dependency_missing` | Playwright Python 库或 Chrome 不可用 | `pip install --upgrade lanhu-design-mcp` |\n| `profile_locked` | 托管 Profile 被其他进程占用 | 等待完成后重试 |\n| `cancelled` | 登录窗口在认证完成前关闭 | 重新运行 `lanhu-design-mcp auth login` |\n| `timed_out` | 登录窗口 5 分钟内未完成认证 | 重新运行 `lanhu-design-mcp auth login` |\n\n## 开发验证\n\n```bash\ngit clone https://github.com/blantian/lanhu-design-mcp\ncd lanhu-design-mcp\nuv sync --dev\nuv run pytest\n```\n\n## 许可证\n\nMIT\n",
  "bytes": 2193,
  "sha": "1dd79439468c4d2da362dbdbff99f312ee666e390d58f7b70146cfd472ab9400",
  "repo_slug": "blantian/lanhu-design-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_blantian_lanhu_design_mcp_6b1580c0/readme"
}