{"_id":"mcp-lanhu","_rev":"7-782e073e714e79e9a752e9e744a9fcbe","name":"mcp-lanhu","dist-tags":{"latest":"2.0.2"},"versions":{"1.0.1":{"name":"mcp-lanhu","version":"1.0.1","keywords":["mcp","lanhu","蓝湖","design","ai","cursor","claude"],"author":{"name":"MrDgbot"},"license":"MIT","_id":"mcp-lanhu@1.0.1","maintainers":[{"name":"dg23","email":"goodevilbot@gmail.com"}],"homepage":"https://github.com/MrDgbot/lanhu-mcp#readme","bugs":{"url":"https://github.com/MrDgbot/lanhu-mcp/issues"},"bin":{"mcp-lanhu":"dist/server.js"},"dist":{"shasum":"f6b9abe25a11dea7519e4ea88d2bfcfa2cc6b267","tarball":"https://registry.npmjs.org/mcp-lanhu/-/mcp-lanhu-1.0.1.tgz","fileCount":26,"integrity":"sha512-TZ7hZlpMdGSs0YPoSh1UMl52syL7mTOTL2rK95uB3RzfOXs8br7HaouRKpT6xM3RXbmvduUSPrgKq1YNMmryhQ==","signatures":[{"sig":"MEQCIFENvrvlJEgQmaJjc7ARDyeydJbIb8g0nQC5ijGnjpczAiAZ7mR9k2htbcJXQfv2682iFCu5YCIo0J1Zo+bgWnTX5w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":141361},"type":"module","engines":{"node":">=20"},"gitHead":"c7625d8b823e39a05a248f991dfe933b32abf7c1","scripts":{"dev":"tsx src/server.ts","test":"vitest run","build":"tsc -p tsconfig.json","check":"tsc --noEmit -p tsconfig.json","start":"node dist/server.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"dg23","email":"goodevilbot@gmail.com"},"repository":{"url":"git+https://github.com/MrDgbot/lanhu-mcp.git","type":"git"},"_npmVersion":"11.10.0","description":"MCP server for Lanhu (蓝湖) design collaboration platform — lets AI assistants read designs, PRDs and slices.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^4.1.12","@modelcontextprotocol/sdk":"^1.18.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","vitest":"^4.1.2","typescript":"^5.9.3","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-lanhu_1.0.1_1775009035019_0.4379897736313727","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"mcp-lanhu","version":"1.0.2","keywords":["mcp","lanhu","蓝湖","design","ai","cursor","claude"],"author":{"name":"MrDgbot"},"license":"MIT","_id":"mcp-lanhu@1.0.2","maintainers":[{"name":"dg23","email":"goodevilbot@gmail.com"}],"homepage":"https://github.com/MrDgbot/lanhu-mcp#readme","bugs":{"url":"https://github.com/MrDgbot/lanhu-mcp/issues"},"bin":{"mcp-lanhu":"dist/server.js"},"dist":{"shasum":"3f066381f748a36e164315ee42bb1a082624261f","tarball":"https://registry.npmjs.org/mcp-lanhu/-/mcp-lanhu-1.0.2.tgz","fileCount":26,"integrity":"sha512-LqmjnxaM5Oo1K2lKJpyGvhNZvFQ0k7DSFXwkQUPCMeztMsXMfrlLdHoOLNzNjhTzxhnU4GnRLYB0LwlHPrdKsQ==","signatures":[{"sig":"MEUCIQDWYogUTmEmoefbzfMZfYnEy1rnTB0soxcQXmBkPmIhiwIgKl18OmctQUg6yUbU9qOPoD0u5bA3CmDOh2+iFZzzn0Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":141627},"type":"module","engines":{"node":">=20"},"gitHead":"7a15022d5b86e0c96e767ac5ec3741b3e6fa6578","scripts":{"dev":"tsx src/server.ts","test":"vitest run","build":"tsc -p tsconfig.json","check":"tsc --noEmit -p tsconfig.json","start":"node dist/server.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"dg23","email":"goodevilbot@gmail.com"},"repository":{"url":"git+https://github.com/MrDgbot/lanhu-mcp.git","type":"git"},"_npmVersion":"11.10.0","description":"MCP server for Lanhu (蓝湖) design collaboration platform — lets AI assistants read designs, PRDs and slices.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^4.1.12","@modelcontextprotocol/sdk":"^1.18.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","vitest":"^4.1.2","typescript":"^5.9.3","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-lanhu_1.0.2_1775011235262_0.4998123642536345","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"mcp-lanhu","version":"2.0.0","keywords":["mcp","mcp-server","model-context-protocol","lanhu","蓝湖","design","design-to-code","figma-alternative","ai","cursor","windsurf","claude","claude-desktop","claude-code","html-css","design-tokens","prd","prototype","ui-design","frontend"],"author":{"name":"MrDgbot"},"license":"MIT","_id":"mcp-lanhu@2.0.0","maintainers":[{"name":"dg23","email":"goodevilbot@gmail.com"}],"homepage":"https://github.com/MrDgbot/lanhu-mcp#readme","bugs":{"url":"https://github.com/MrDgbot/lanhu-mcp/issues"},"bin":{"mcp-lanhu":"dist/server.js"},"dist":{"shasum":"53b162846a8cada155bde608d9f03565381698b2","tarball":"https://registry.npmjs.org/mcp-lanhu/-/mcp-lanhu-2.0.0.tgz","fileCount":24,"integrity":"sha512-2UV3Hv6qu+q+1vZ9AfAOjzA3HLerr+KpIQ5hNZK7A/hEqrjXfYsTHuHM3eaQMpusD+d1HwpQVhtvhyX6PHjvAg==","signatures":[{"sig":"MEUCIQC2qaeiH8pQKzjHmjQ/ayGPgldlXEJ5HRhP1zcq2n/iKwIgAz44BQ8RxmNyA+VmxeXfTRHcFS2Sdr+RQwgKgQiLhZs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":153845},"type":"module","engines":{"node":">=20"},"gitHead":"fcb108ae0eea8bb26adb85615bd3dee77c8fc141","scripts":{"dev":"tsx src/server.ts","test":"vitest run","build":"tsc -p tsconfig.json","check":"tsc --noEmit -p tsconfig.json","start":"node dist/server.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"dg23","email":"goodevilbot@gmail.com"},"repository":{"url":"git+https://github.com/MrDgbot/lanhu-mcp.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for Lanhu (蓝湖) design collaboration platform — lets AI assistants read designs, PRDs and slices.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^4.1.12","@modelcontextprotocol/sdk":"^1.18.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","vitest":"^4.1.2","typescript":"^5.9.3","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-lanhu_2.0.0_1775645682833_0.633410939500866","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"mcp-lanhu","version":"2.0.1","keywords":["mcp","mcp-server","model-context-protocol","lanhu","蓝湖","design","design-to-code","figma-alternative","ai","cursor","windsurf","claude","claude-desktop","claude-code","html-css","design-tokens","prd","prototype","ui-design","frontend"],"author":{"name":"MrDgbot"},"license":"MIT","_id":"mcp-lanhu@2.0.1","maintainers":[{"name":"dg23","email":"goodevilbot@gmail.com"}],"homepage":"https://github.com/MrDgbot/lanhu-mcp#readme","bugs":{"url":"https://github.com/MrDgbot/lanhu-mcp/issues"},"bin":{"mcp-lanhu":"dist/server.js"},"dist":{"shasum":"14bd1cd829eaf1f4b699d75e7965c25292a0c3c6","tarball":"https://registry.npmjs.org/mcp-lanhu/-/mcp-lanhu-2.0.1.tgz","fileCount":24,"integrity":"sha512-LtWKKWt7xsziuMjamHwcFqnWq2dffDscHuNjV48tz8BIBSwyUyxrd+P2b71nVLm3j+hV3jVzrnCh82LRlDAUvw==","signatures":[{"sig":"MEQCIARVgtw3DK6rRtpccauI056UC2eD6f1EOjYcMGuDDKI+AiB80OHmAtDHM8FHWIQQXQheQ0bZ+abdFenKFGErpRRG/Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":152411},"type":"module","engines":{"node":">=20"},"gitHead":"8fcc343725d0e029bf190c9f6b9b40b3257cae40","scripts":{"dev":"tsx src/server.ts","test":"vitest run","build":"tsc -p tsconfig.json","check":"tsc --noEmit -p tsconfig.json","start":"node dist/server.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"dg23","email":"goodevilbot@gmail.com"},"repository":{"url":"git+https://github.com/MrDgbot/lanhu-mcp.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for Lanhu (蓝湖) design collaboration platform — lets AI assistants read designs, PRDs and slices.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^4.1.12","@modelcontextprotocol/sdk":"^1.18.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","vitest":"^4.1.2","typescript":"^5.9.3","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-lanhu_2.0.1_1778037187373_0.4035547784984397","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"mcp-lanhu","version":"2.0.2","description":"MCP server for Lanhu (蓝湖) design collaboration platform — lets AI assistants read designs, PRDs and slices.","type":"module","license":"MIT","author":{"name":"MrDgbot"},"repository":{"type":"git","url":"git+https://github.com/MrDgbot/lanhu-mcp.git"},"keywords":["mcp","mcp-server","model-context-protocol","lanhu","蓝湖","design","design-to-code","figma-alternative","ai","cursor","windsurf","claude","claude-desktop","claude-code","html-css","design-tokens","prd","prototype","ui-design","frontend"],"engines":{"node":">=20"},"bin":{"mcp-lanhu":"dist/server.js"},"scripts":{"build":"tsc -p tsconfig.json","check":"tsc --noEmit -p tsconfig.json","dev":"tsx src/server.ts","start":"node dist/server.js","prepublishOnly":"npm run build","test":"vitest run"},"dependencies":{"@modelcontextprotocol/sdk":"^1.18.1","zod":"^4.1.12"},"devDependencies":{"@types/node":"^24.5.2","tsx":"^4.20.5","typescript":"^5.9.3","vitest":"^4.1.2"},"_id":"mcp-lanhu@2.0.2","gitHead":"1c675360ee9330b70056b875da38a250af49fed4","bugs":{"url":"https://github.com/MrDgbot/lanhu-mcp/issues"},"homepage":"https://github.com/MrDgbot/lanhu-mcp#readme","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-xu7rJxEJZQQHaw7E7J43YY9PMmkP10vequUShmyEVb8b75X2Q4FLv6hgMSWEyA9ie/fglxXiTbd5iwZkOrYhMA==","shasum":"b462c83724019196c7b146dffd7bf9ffb2be629f","tarball":"https://registry.npmjs.org/mcp-lanhu/-/mcp-lanhu-2.0.2.tgz","fileCount":26,"unpackedSize":184517,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDhU8QUDgZQfgMOJWztVOE398tRtzqAuFQfJF3uM5LdxAIhALuBcUK73WGMJ3L+McRdiqjji7yaQuZI1w3KOV7Mqq2h"}]},"_npmUser":{"name":"dg23","email":"goodevilbot@gmail.com"},"directories":{},"maintainers":[{"name":"dg23","email":"goodevilbot@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-lanhu_2.0.2_1786094390671_0.12820891987101346"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T01:37:33.941Z","modified":"2026-08-07T09:19:51.062Z","1.0.0":"2026-04-01T01:37:34.190Z","1.0.1":"2026-04-01T02:03:55.217Z","1.0.2":"2026-04-01T02:40:35.416Z","2.0.0":"2026-04-08T10:54:43.000Z","2.0.1":"2026-05-06T03:13:07.514Z","2.0.2":"2026-08-07T09:19:50.905Z"},"bugs":{"url":"https://github.com/MrDgbot/lanhu-mcp/issues"},"author":{"name":"MrDgbot"},"license":"MIT","homepage":"https://github.com/MrDgbot/lanhu-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","lanhu","蓝湖","design","design-to-code","figma-alternative","ai","cursor","windsurf","claude","claude-desktop","claude-code","html-css","design-tokens","prd","prototype","ui-design","frontend"],"repository":{"type":"git","url":"git+https://github.com/MrDgbot/lanhu-mcp.git"},"description":"MCP server for Lanhu (蓝湖) design collaboration platform — lets AI assistants read designs, PRDs and slices.","maintainers":[{"name":"dg23","email":"goodevilbot@gmail.com"}],"readme":"<div align=\"center\">\n\n# 🎨 蓝湖 MCP Server\n\n**让 AI 编程助手直接读取蓝湖设计稿、提取代码、解析需求文档**\n\n[![npm version](https://img.shields.io/npm/v/mcp-lanhu)](https://www.npmjs.com/package/mcp-lanhu)\n[![npm downloads](https://img.shields.io/npm/dm/mcp-lanhu)](https://www.npmjs.com/package/mcp-lanhu)\n[![MIT License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)\n\n[English](docs/README_EN.md)\n\n</div>\n\n---\n\n## 这是什么\n\n`mcp-lanhu` 是蓝湖的 [MCP](https://modelcontextprotocol.io/) 服务器，装上之后 **Cursor、Windsurf、Claude Desktop、Claude Code** 都能直接连接蓝湖。AI 可以读取设计稿、提取 HTML/CSS、解析 PRD、下载切图，全程不用离开编辑器。\n\n> **一行命令，零配置** — `npx -y mcp-lanhu`，粘贴蓝湖链接就能用。\n\n### 核心能力\n\n- **设计稿 → 代码**：生成像素级 HTML + CSS，含完整 Design Tokens（颜色、字体、阴影、渐变）\n- **结构化 Design Tokens**：提取所有颜色、字体族/字号/字重、阴影、边框、圆角，按使用频率排序\n- **PRD 驱动开发**：将 PRD 或 Axure 原型交给 AI，需求感知编码\n- **自动切图**：直接从蓝湖提取切图、图标和图片，无需手动导出\n- **并发 + 重试**：多设计稿并行分析，网络异常自动重试\n- **MCP Resources & Prompts**：内置前端开发和设计走查 Prompt 模板\n\n---\n\n## 安装\n\n### 最快方式：让 AI 帮你装\n\n复制下面这段话，发给你的 AI 助手（Cursor / Claude Code / Windsurf）：\n\n> 帮我安装蓝湖 MCP 服务器：https://github.com/MrDgbot/lanhu-mcp\n\nAI 会自动读取仓库说明并完成配置，你只需要提供蓝湖 Cookie。\n\n---\n\n### 手动配置\n\n无需 clone 代码，`npx` 自动安装。\n\n**Cursor / Windsurf** — 编辑 `.cursor/mcp.json`（或 `.windsurf/mcp.json`）：\n\n```json\n{\n  \"mcpServers\": {\n    \"lanhu\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-lanhu\"],\n      \"env\": { \"LANHU_COOKIE\": \"your_cookie_here\" }\n    }\n  }\n}\n```\n\n**Claude Desktop** — 编辑 `claude_desktop_config.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"lanhu\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-lanhu\"],\n      \"env\": { \"LANHU_COOKIE\": \"your_cookie_here\" }\n    }\n  }\n}\n```\n\n**Claude Code**：\n\n```bash\nclaude mcp add lanhu -- npx -y mcp-lanhu\n```\n\n然后设置环境变量 `LANHU_COOKIE`。\n\n### 获取 Cookie\n\n1. 登录 [蓝湖](https://lanhuapp.com)\n2. F12 打开开发者工具 → Network 标签\n3. 复制任意请求的 `Cookie` 请求头\n\n配置完成后重启客户端，粘贴蓝湖链接即可使用。\n\n---\n\n## 工具\n\n### `lanhu_design` — 设计稿\n\n通过 `mode` 参数切换功能：\n\n| Mode | 说明 |\n|------|------|\n| `list` | 列出项目所有设计图 |\n| `analyze` | 设计图 → HTML+CSS + Design Tokens（默认） |\n| `tokens` | 仅提取 Design Tokens（字体、颜色、阴影等） |\n| `slices` | 提取切图资源 |\n\n`analyze` 模式支持 `include` 参数按需选择输出：`html`、`image`、`tokens`、`layout`、`layers`、`slices`。默认 `[\"html\", \"tokens\", \"layers\", \"image\"]`。请求 `layers` 时可用 `layer_depth` 控制嵌套深度：默认 `4`，`0` 仅返回顶层，`\"all\"` 返回完整图层树。每个设计会按请求项返回 `success`、`partial_success` 或 `error`，结构化图层标注位于 `layer_annotations`。\n\n**Design Tokens 输出示例：**\n\n```\n=== Design Tokens ===\n\nColors (12 unique):\n  rgba(140,140,140,1) x48\n  rgba(255,255,255,1) x28\n  rgba(51,51,51,1) x12\n  ...\n\nFonts (7 unique):\n  Source Han Sans CN / Regular / 14px x25\n  PingFang SC / Bold / 10px x3\n  ...\n\nShadows (3 unique):\n  rgba(0,81,187,0.03) 0px 0px 0px 1px x3\n  ...\n```\n\n### `lanhu_page` — PRD / 原型\n\n| Mode | 说明 |\n|------|------|\n| `list` | 列出 PRD 所有页面 |\n| `analyze` | PRD/原型 → 结构化分析（默认） |\n\n### `lanhu_resolve_invite` — 解析邀请链接\n\n将蓝湖分享链接解析为可用的项目 URL。\n\n---\n\n## MCP Resources & Prompts\n\n| 类型 | 名称 | 说明 |\n|------|------|------|\n| Resource | `project-designs` | 项目设计稿列表（`lanhu://project/{pid}/designs?tid={tid}`） |\n| Prompt | `frontend-dev` | 根据设计稿生成像素级前端代码 |\n| Prompt | `design-review` | 审查设计一致性和可实现性 |\n\n---\n\n## 使用场景\n\n- **前端开发**：粘贴蓝湖链接 → AI 生成与设计稿匹配的组件代码\n- **设计走查**：对比实现与 Design Tokens（间距、颜色、字体）\n- **需求实现**：将 PRD 交给 AI，需求驱动的功能开发\n- **资源导出**：批量提取图标和图片\n\n---\n\n## 兼容性\n\n| 客户端 | 支持 | 传输 |\n|--------|------|------|\n| Cursor | ✅ | stdio |\n| Windsurf | ✅ | stdio |\n| Claude Desktop | ✅ | stdio |\n| Claude Code | ✅ | stdio |\n| 其他 MCP 兼容 IDE | ✅ | stdio |\n\n---\n\n## 开发\n\n```bash\ngit clone https://github.com/MrDgbot/lanhu-mcp.git && cd lanhu-mcp\nnpm install && cp config.example.env .env  # 填入 LANHU_COOKIE\nnpm run dev    # 开发模式\nnpm run build  # 构建\nnpm test       # 测试\n```\n\n---\n\n## FAQ\n\n**Q: 什么是 MCP？**\nA: [Model Context Protocol](https://modelcontextprotocol.io/)，让 AI 助手安全连接外部工具的开放标准。\n\n**Q: 支持哪些蓝湖套餐？**\nA: 任何可网页访问的蓝湖账号，通过浏览器 Cookie 认证。\n\n**Q: `analyze` 返回太大怎么办？**\nA: 用 `include` 参数，如 `[\"tokens\"]` 只返回 Design Tokens；不需要 base64 图片时请不要包含 `image`。\n\n**Q: 不用 Cursor 也能用？**\nA: 能。支持所有 MCP 客户端。\n\n---\n\n## License\n\n[MIT](LICENSE) © [MrDgbot](https://github.com/MrDgbot)\n","readmeFilename":"README.md"}