dsphper/lanhu-mcp

⚡ 需求分析效率提升 200%！全球首个为 AI 编程时代设计的团队协作 MCP 服务器，自动分析需求自动编写前后端代码，下载切图

📚 概述

Lanhu MCP Server 是一个开源桥接器，让 AI 驱动的开发助手（例如 Cursor、Claude Code、Windsurf）能够读取并操作存储在 Lan-Hu 设计协作平台中的数据。它实现了 模型上下文协议 (MCP)，公开了一个 HTTP/STDIO API，返回关于需求文档、UI 模拟稿和设计资产的结构化信息。服务器还提供了一个共享的“团队知识板”，让多个 AI 代理可以复用彼此的分析结果。

✨ 核心功能（根据 README 描述）

功能	作用	重要性
需求文档分析	从 Lan-Hu 下载 Axure 页面，提取文本、注释和视觉证据，并运行支持视觉的 LLM 生成面向开发者、测试者或探索者的报告。	将原始设计规格转化为可操作的规格，无需每个 AI 重新解析同一文档。
UI 设计支持	获取设计稿，切片图像，提取布局参数（尺寸、间距、颜色、字体），并生成 HTML + CSS 脚手架。	为 AI 代理提供具体的 UI 数据，以便将其转化为代码。
团队知识板	集中式消息存储（知识、任务、问题、紧急警报），支持 @提及、飞书 webhook 通知和按用户访问跟踪。	使多个 AI 助手能够共享见解并避免重复工作。
性能优化	基于版本的缓存、增量更新、并发页面截图和资产下载。	即使对于大型设计项目也能保持低延迟。
FastMCP 框架	基于开源 FastMCP 服务器构建，通过 HTTP 或 stdio 实现 MCP 协议。	允许理解 MCP 的 AI IDE 通过长期运行的 HTTP 服务或短期 stdio 进程连接。
Docker 和本地部署	一键 Docker compose、`easy-install` 脚本，以及用于快速本地使用的单文件 `lanhu_mcp_server.py`。	降低了团队在本地运行服务的门槛。
可配置钩子	支持环境变量配置 Lan-Hu Cookie、飞书 webhook、服务器主机/端口、视口大小、超时等。	使服务器能够适应不同的网络和 UI 测试环境。

🛠️ 快速开始（简要总结）

获取 Lan-Hu Cookie – 登录 Lan-Hu Web UI 并复制 Cookie 头。
克隆仓库，然后执行以下任一操作：
- 运行 docker compose up -d --build（推荐），或
- 运行 easy-install.sh / easy-install.bat 脚本，设置 Python 3.10+ 虚拟环境，安装依赖并启动服务器。
启动服务 – 可以是 HTTP 服务器（lanhu-mcp --transport http）或 stdio 包装器（run-stdio.sh）。
配置你的 AI IDE – 添加一个指向 http://localhost:8000/mcp（或 stdio 命令）的 MCP 条目，并包含 role 和 name 查询参数。
交互 – 让 AI 助手对 Lan-Hu 文档 URL 执行 mcp 操作；服务器将返回结构化分析、设计预览或切片资产。

📦 项目结构（高层）

lanhu-mcp-server/
├─ lanhu_mcp_server.py      # 主 FastMCP 入口点（大型单体文件）
├─ requirements.txt         # Python 依赖（FastMCP、Playwright 等）
├─ Dockerfile, docker-compose.yml
├─ easy-install.sh / .bat   # 用于本地设置的辅助脚本
├─ config.example.env       # 环境变量示例
├─ docs/ (README_EN.md, RELEASE_NOTES_*.md, …)
└─ tools/                   # 单个 MCP 工具实现（例如 lanhu_get_designs）

🎯 谁应该使用？

已经在 Lan-Hu 中存储产品需求和 UI 模拟稿，并希望 AI 编码助手自动消费这些数据的团队。
构建需要多个代理之间 共享知识库 的自定义 AI 代理工作流的开发者。
更倾向于本地部署而非 SaaS 解决方案的组织，因为服务器只需要一个 Lan-Hu Cookie，并且运行在团队的防火墙后面。

⚠️ 限制和未决问题（来自 README）

服务器 需要支持视觉的 LLM（Claude、GPT-4-Vision、Gemini-Vision 等）。纯文本模型无法工作。
对 Lan-Hu 数据的访问受用户特定 Cookie 控制；每个团队成员必须提供有效的 Cookie，服务器才能获取资源。
安全敏感的操作仅限于只读查询；知识板强制执行安全操作白名单。

📚 进一步阅读

Model Context Protocol (MCP): https://modelcontextprotocol.io/
FastMCP 框架: https://github.com/jlowin/fastmcp
Lan-Hu 平台文档（链接在仓库的 README 中）。

以上所有信息均直接取自仓库的 README；未推断任何额外功能。