mcp-lanhu
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-lanhu Analyze this Lanhu design and generate HTML/CSS: https://lanhuapp.com/xxx"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🎨 蓝湖 MCP Server
让 AI 编程助手直接读取蓝湖设计稿、提取代码、解析需求文档、下载切图
这是什么
mcp-lanhu 是蓝湖的 MCP 服务器,装上之后 Cursor、Windsurf、Claude Desktop、Claude Code 都能直接连接蓝湖。AI 可以读取设计稿、提取 HTML/CSS、解析 PRD、下载切图,全程不用离开编辑器。
核心能力
设计稿 → 代码:生成像素级 HTML + CSS,含完整 Design Tokens(颜色、字体、阴影、渐变)
结构化 Design Tokens:提取所有颜色、字体族/字号/字重、阴影、边框、圆角,按使用频率排序
PRD 驱动开发:将 PRD 或 Axure 原型交给 AI,需求感知编码
自动切图:提取并下载设计师标记的切图到本地,可生成
manifest.json溯源并发 + 重试:多设计稿并行分析,网络异常自动重试
MCP Resources & Prompts:内置前端开发和设计走查 Prompt 模板
Related MCP server: lanhu-mcp-server
安装
手动配置
Cursor / Windsurf — 编辑 .cursor/mcp.json(或 .windsurf/mcp.json):
{
"mcpServers": {
"lanhu": {
"command": "npx",
"args": ["-y", "mcp-lanhu"],
"env": { "LANHU_COOKIE": "your_cookie_here" }
}
}
}Claude Desktop — 编辑 claude_desktop_config.json:
{
"mcpServers": {
"lanhu": {
"command": "npx",
"args": ["-y", "mcp-lanhu"],
"env": { "LANHU_COOKIE": "your_cookie_here" }
}
}
}Claude Code:
claude mcp add lanhu -- npx -y mcp-lanhu然后设置环境变量 LANHU_COOKIE。
获取 Cookie
登录 蓝湖
F12 打开开发者工具 → Network 标签
复制任意请求的
Cookie请求头
配置完成后重启客户端,粘贴蓝湖链接即可使用。
工具
lanhu_design — 设计稿
通过 mode 参数切换功能:
Mode | 说明 |
| 列出项目所有设计图 |
| 设计图 → HTML+CSS + Design Tokens(默认) |
| 仅提取 Design Tokens(字体、颜色、阴影等) |
| 提取设计师标记的可导出切图信息 |
| 下载切图到本地目录,可写 |
analyze 模式支持 include 参数按需选择输出:html、image、tokens、layout、layers、slices,默认 ["html", "tokens", "layers", "image"]。请求 layers 时可用 layer_depth 控制嵌套深度:默认 4,0 仅返回顶层,"all" 返回完整图层树。
download 模式相关参数:
download_dir:切图保存目录(必填,绝对或相对路径)write_manifest:设为true时额外生成manifest.json,记录「本地文件 ↔ 原图层名 ↔ 语义名 ↔ 蓝湖 CDN URL」的映射
Design Tokens 输出示例:
=== Design Tokens ===
Colors (12 unique):
rgba(140,140,140,1) x48
rgba(255,255,255,1) x28
rgba(51,51,51,1) x12
...
Fonts (7 unique):
Source Han Sans CN / Regular / 14px x25
PingFang SC / Bold / 10px x3
...
Shadows (3 unique):
rgba(0,81,187,0.03) 0px 0px 0px 1px x3
...lanhu_page — PRD / 原型
Mode | 说明 |
| 列出 PRD 所有页面 |
| PRD/原型 → 结构化分析(默认) |
analyze 模式支持 analysis_mode 切换分析视角:developer(开发,默认)、tester(测试)、explorer(探索)。
lanhu_resolve_invite — 解析邀请链接
将蓝湖分享链接解析为可用的项目 URL。
MCP Resources & Prompts
类型 | 名称 | 说明 |
Resource |
| 项目设计稿列表( |
Prompt |
| 根据设计稿生成像素级前端代码 |
Prompt |
| 审查设计一致性和可实现性 |
使用场景
前端开发:粘贴蓝湖链接 → AI 生成与设计稿匹配的组件代码
设计走查:对比实现与 Design Tokens(间距、颜色、字体)
需求实现:将 PRD 交给 AI,需求驱动的功能开发
资源导出:批量提取并下载图标和图片
兼容性
客户端 | 支持 | 传输 |
Cursor | ✅ | stdio |
Windsurf | ✅ | stdio |
Claude Desktop | ✅ | stdio |
Claude Code | ✅ | stdio |
其他 MCP 兼容 IDE | ✅ | stdio |
开发
git clone https://github.com/Shaolih0603/lanhu-mcp.git
cd lanhu-mcp
npm install
cp config.example.env .env # 填入 LANHU_COOKIE
npm run dev # 开发模式
npm run build # 构建
npm test # 测试FAQ
Q: 什么是 MCP? A: Model Context Protocol,让 AI 助手安全连接外部工具的开放标准。
Q: 支持哪些蓝湖套餐? A: 任何可网页访问的蓝湖账号,通过浏览器 Cookie 认证。
Q: analyze 返回太大怎么办?
A: 用 include 参数,如 ["tokens"] 只返回 Design Tokens;不需要 base64 图片时请不要包含 image。
Q: 不用 Cursor 也能用? A: 能。支持所有 MCP 客户端。
License
本项目基于 MrDgbot/lanhu-mcp 二次开发,遵循 MIT 协议。
Available Tools
3 toolslanhu_designA
Unified Lanhu design tool. Supports listing, analyzing, extracting tokens, and getting slices.
Modes:
list: List all designs in the project
analyze: Full design analysis with HTML+CSS, tokens, layers, and image (default)
slices: Extract slice/asset info for download
download: Download designer-marked exportable slices to a local directory and write a manifest.json mapping local files to CDN URLs
tokens: Extract design tokens only (fonts, colors, shadows, etc.)
For detailDetach URLs (contains image_id), pass design_names='all'.
Inputs: url (required), mode, include, layer_depth, +4 more.
lanhu_pageB
Unified Lanhu PRD/prototype tool. Supports listing and analyzing pages.
Modes:
list: List all pages in a PRD/prototype document
analyze: Analyze specified pages (default)
Inputs: url (required), mode, page_names, analysis_mode.
lanhu_resolve_invite_linkB
Resolve Lanhu invite/share link to actual project URL with tid/pid/docId parameters.
Inputs: invite_url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools have clearly distinct purposes: resolving invite links, working with designs, and working with pages. Even with modes inside design and page, the resource type separation is unambiguous.
All tools share the lanhu_ prefix, but lanhu_resolve_invite_link uses a verb_noun pattern while lanhu_design and lanhu_page are plain nouns. The naming is readable but not fully consistent in verb usage.
Three tools is a reasonable count, though the design and page tools bundle many modes, making them somewhat overloaded. Still, the scope is manageable and each tool earns its place.
The surface covers listing, analyzing, extracting tokens, downloading slices, and resolving links—all common read-only operations for a design tool. Missing create/update operations, but that may be intentional for a design inspection server.
Maintenance
Related MCP Connectors
Give AI coding agents access to your Vynix visual feedback, bug reports, and AI diagnosis.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Connect AI coding agents to Anima Playground, Figma, and your design system.
Draw architecture diagrams, UML, planning boards and clickable wireframes from your AI assistant.
1
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI to directly read and analyze Lanhu design drafts and requirement documents to generate HTML, CSS, and structural analyses. It allows users to extract design slices and process prototype pages directly within AI clients.3301 npm148MIT
- AlicenseAqualityCmaintenanceEnables AI coding tools to read Lanhu design data and automate Design to Code, including project browsing, layer tree extraction, DDS semantic components, and code generation.1458 npm4MIT
- AlicenseAqualityCmaintenanceProvides AI coding agents with structured access to Lanhu design data, enabling direct inspection of artboards, extraction of pixel-perfect layer styles and CSS attributes, and downloading of design assets without vision token overhead.9MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to connect to the Lanhu design collaboration platform, allowing them to analyze requirement documents, inspect UI designs with detailed parameters, download design slices, and share team knowledge through a collaborative message board.MIT