Skip to main content
Glama
kaminof3tt

Life Saver MCP

by kaminof3tt
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Life Saver MCP

图片识别 & 网页内容分析 MCP Server。支持直接传图、蓝湖设计稿、禅道 Bug/需求/任务以及任意网页 URL 的智能分析。

功能

analyze_image — 图片识别

传入图片（本地路径 / base64 / 图片 URL），AI 自动识别场景并结构化输出。

  • UI 原型/设计稿 → 组件结构、布局、交互说明、样式标注

  • Bug 截图 → 异常描述、可能原因、影响范围、修复建议

  • 需求文档 → 关键需求、验收标准、业务规则

  • 通用图片 → 客观描述

支持格式：PNG / JPEG / GIF（自动提取关键帧）/ WebP（含动画）/ APNG / BMP，单文件限制 10MB。动画图片自动提取多帧传给 AI。

analyze_url — 网页内容分析

传入 URL，自动识别来源并拉取内容后 AI 整理输出。

参数：

  • url（必填）— 要分析的网页 URL

  • hint（可选）— 告诉 AI 重点关注什么

  • max_pages（可选，默认全部）— 蓝湖 Axure 文档截图页数上限，不传则所有页面都截图

  • max_images（可选，默认全部）— 传给 AI 的图片数量上限；不传则页面所有图片都传给 AI，传数字可限制（页面图多时防止超出模型上下文）

  • force_refresh（可选，默认 false）— 强制忽略缓存重新拉取

来源

认证方式

能力

蓝湖 (lanhuapp.com)

Cookie

设计稿图片、Axure 原型截图、设计标注、切图提取

禅道 (zentao)

Cookie / 密码 / Token

Bug/需求/任务详情、图片、附件、历史记录

通用网页

无

抓取文字和图片

status — 服务状态

返回当前已启用的 handler、provider 列表和默认 provider，方便调试配置问题。

蓝湖能力

设计稿 URL（无 docId 参数）：

https://lanhuapp.com/web/#/item/project/product?tid=xxx&pid=xxx
https://lanhuapp.com/web/#/item/project/stage?tid=xxx&pid=xxx

自动提取：

  • 设计图列表 + 图片下载（转 base64 传 AI）

  • 设计标注（Sketch JSON → 文字/形状/图层信息、颜色、字体、阴影、圆角等）

  • 设计 Token（渐变、边框、非均匀圆角等高风险元素）

  • 切图/素材（下载链接 + 多分辨率 URL：1x/2x/3x/iOS/Android）

PRD 文档 URL（带 docId 参数）：

https://lanhuapp.com/web/#/item/project/product?tid=xxx&pid=xxx&docId=xxx

自动提取：

  • Axure 原型页面截图（Playwright 渲染，支持落盘缓存）

  • 页面文字内容

  • 文档版本信息

Axure 截图缓存：首次拉取后，资源和截图持久化到 ~/.life-saver-mcp/cache/lanhu_axure/{doc_id}/，二次读取秒级返回。缓存通过 version_id 校验，原型更新后自动重新拉取。支持增量缓存（第一次拉 5 页，第二次拉 10 页，前 5 页从缓存读）。缓存目录可通过 LANHU_CACHE_DIR 环境变量自定义。

蓝湖需要 Cookie 认证，DDS API 需要单独的 DDS_COOKIE（默认复用 LANHU_COOKIE）。

禅道支持的 URL 格式

?m=bug&f=view&bugID=1081                              # Bug
?m=story&f=view&id=572                                 # 研发需求
?m=requirement&f=view&storyID=495                       # 用户需求
?m=projectstory&f=view&storyID=434&projectID=146        # 项目需求
?m=task&f=view&taskID=314                               # 任务

禅道页面通过 ZIN 框架解析，自动提取：

  • 基本信息字段（产品、模块、优先级、状态、指派等）

  • 正文内容（重现步骤 / 需求描述 / 任务描述）

  • 内嵌图片（自动下载转 base64 传给 AI）

  • 附件文件（提取文件名、类型、大小、尺寸、下载链接，供调用方判断是否需要下载解析）

  • 历史记录 / 备注

禅道认证方式

禅道支持三种认证方式，通过 auth.type 配置：

auth.type

环境变量

说明

cookie（默认）

ZENTAO_COOKIE

手动从浏览器复制 Cookie（需含 zentaosid 和 zp）

password

ZENTAO_ACCOUNT + ZENTAO_PASSWORD

自动模拟登录，无需手动复制 Cookie

token

ZENTAO_TOKEN

通过 Token header 认证

密码登录是最省心的方式：配置账号密码后自动登录，密码改了也自动适应，不用重新抓 Cookie。登录 session 缓存 1 小时，避免每次请求重新登录。登录流程：获取 refreshRandom 随机数 → md5(md5(password) + rand) 加密密码 → POST 登录 → 拿到 zentaosid + zp cookie。

Related MCP server: Zentao Bug MCP

快速开始

安装

pip install -e .
# 安装开发依赖（测试、lint、类型检查）
pip install -e ".[dev]"

配置

life-saver-mcp.json：

{
  "handlers": {
    "lanhu": {
      "enabled": true,
      "auth": { "type": "cookie", "env": "LANHU_COOKIE" }
    },
    "zentao": {
      "enabled": true,
      "url": "http://zentao.example.com",
      "auth": { "type": "password" }
    }
  },
  "providers": [
    {
      "type": "openai",
      "api_key_env": "OPENAI_API_KEY",
      "base_url": "https://api.openai.com/v1",
      "models": ["gpt-4o"],
      "default": true
    }
  ]
}

配置文件查找顺序：--config 参数 > LIFE_SAVER_CONFIG 环境变量 > 当前目录 life-saver-mcp.json > ~/.config/life-saver-mcp/config.json > 内置默认配置。

支持 .env 文件自动加载（需安装 python-dotenv，已包含在依赖中）。在项目根目录放 .env 文件即可自动读取环境变量。

环境变量

变量

说明

OPENAI_API_KEY

OpenAI API Key（或兼容接口的 Key）

GOOGLE_API_KEY

Google Gemini API Key

ANTHROPIC_API_KEY

Anthropic Claude API Key

LANHU_COOKIE

蓝湖 Cookie（从浏览器 DevTools → Network → 任意请求的 Cookie header 复制）

DDS_COOKIE

蓝湖 DDS API Cookie（可选，默认复用 LANHU_COOKIE）

ZENTAO_COOKIE

禅道 Cookie（cookie 认证模式，需包含 zentaosid 和 zp）

ZENTAO_ACCOUNT

禅道账号（password 认证模式）

ZENTAO_PASSWORD

禅道密码（password 认证模式）

ZENTAO_TOKEN

禅道 Token（token 认证模式）

LIFE_SAVER_CONFIG

自定义配置文件路径

LANHU_CACHE_DIR

蓝湖 Axure 缓存目录（默认 ~/.life-saver-mcp/cache/lanhu_axure/）

LOG_LEVEL

日志级别（默认 INFO，可选 DEBUG/WARNING/ERROR）

获取禅道 Cookie

  1. 浏览器打开禅道并登录

  2. F12 → Network → 随便点一个请求

  3. 复制 Cookie header 中的完整内容（至少包含 zentaosid 和 zp）

提示：如果不想手动复制 Cookie，可以使用密码认证模式（auth.type: "password"），配置 ZENTAO_ACCOUNT 和 ZENTAO_PASSWORD 即可自动登录。

启动

# stdio 模式（本地 MCP 客户端）
life-saver-mcp --transport stdio

# HTTP 模式（远程部署）
life-saver-mcp --transport streamable-http --port 8000

# SSE 模式（兼容旧客户端）
life-saver-mcp --transport sse --port 8000

MCP 客户端配置

Cursor / Claude Desktop（stdio）：

{
  "mcpServers": {
    "life-saver": {
      "command": "life-saver-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

远程 HTTP：

{
  "mcpServers": {
    "life-saver": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

AI Provider

支持所有 OpenAI 兼容接口，通过 base_url 和 api_key_env 配置：

{
  "type": "openai",
  "api_key_env": "YOUR_API_KEY",
  "base_url": "https://your-api-endpoint.com/v1",
  "models": ["your-model-name"],
  "default": true
}

内置 Provider 类型：openai（兼容所有 OpenAI 接口）、google、anthropic。

Provider 调用内置重试机制（最多 2 次指数退避重试，4xx 错误不重试）。支持故障转移：默认 Provider 失败后自动尝试其他已配置的 Provider。

无 Provider 时，analyze_url 仍可工作，返回原始抓取内容（文字 + 图片数量 + 附件列表），不调用 AI 分析。

架构

用户输入
  │
  ├─ 图片 ────────► analyze_image ──► AI 分析 ──► 结构化结果
  │                                     │
  │                               Provider 故障转移
  │
  └─ URL ─────────► analyze_url
                       │
                       ▼
                  LifeSaverContext（状态封装）
                       │
                  URL Router（HANDLER_REGISTRY）
                       │
                 ┌─────┼──────────┐
                 ▼     ▼          ▼
             Lanhu   Zentao   Generic
            Handler  Handler  Handler
                 │     │          │
           ┌─────┤     │          │
           ▼     ▼     │          │
      Axure    Design  │          │
      Screenshot Info  │          │
      (Playwright)     │          │
      + 落盘缓存       │          │
           │     │     │          │
           │ Annotations          │
           │ + Slices │          │
           └─────┤     │          │
                 ▼     ▼          ▼
                  PageContent
                  ├─ text_sections
                  ├─ images (base64)
                  └─ attachments (metadata + scale_urls)
                       │
                       ▼
                  AI Analyzer
                  (多模态：文字 + 图片)
                       │
                       ▼
                  结构化 JSON

项目结构

src/life_saver_mcp/
├── server.py                   # MCP Server 入口（FastMCP + LifeSaverContext 状态封装）
├── config.py                   # 配置加载 + .env 支持 + Handler 注册表校验
├── models.py                   # Pydantic 数据模型（含 scale_urls）
├── providers/                  # AI Provider 层
│   ├── base.py                 #   BaseProvider 抽象类 + 重试
│   ├── openai_provider.py      #   OpenAI（兼容 base_url）
│   ├── google_provider.py      #   Google Gemini
│   └── anthropic_provider.py   #   Anthropic Claude
├── handlers/                   # URL Handler 层
│   ├── base.py                 #   BaseHandler 抽象类
│   ├── router.py               #   URL 域名路由 + HANDLER_REGISTRY 注册表
│   ├── generic.py              #   通用网页抓取（BeautifulSoup，文本去重，并发下载）
│   ├── lanhu.py                #   蓝湖主逻辑（Cookie + API + Axure 缓存校验）
│   ├── lanhu_axure.py          #   蓝湖 Axure 原型下载 + Playwright 截图 + 落盘缓存
│   ├── lanhu_annotations.py    #   蓝湖设计标注提取（Sketch JSON）
│   ├── lanhu_slices.py         #   蓝湖切图/素材提取（多分辨率 URL）
│   └── zentao.py               #   禅道（Cookie/密码/Token 认证 + ZIN 解析 + session 缓存）
└── analysis/                   # 分析引擎
    ├── prompts.py              #   场景识别 Prompt 模板（图片 + URL 场景化）
    ├── scenario.py             #   结果解析
    └── image_utils.py          #   GIF/WebP/APNG 多帧提取等图片工具

扩展

新增 AI Provider

  1. 在 providers/ 下新建文件，继承 BaseProvider

  2. 实现 analyze_image、analyze_text、analyze_multimodal 三个方法（自动继承 _with_retry 重试机制）

  3. 在 server.py 的 PROVIDER_REGISTRY 中注册

  4. 在 life-saver-mcp.json 的 providers 中添加配置

新增 URL Handler

  1. 在 handlers/ 下新建文件，继承 BaseHandler

  2. 实现 can_handle(url) 和 fetch_content(url, **kwargs) 方法

  3. 在 handlers/router.py 的 HANDLER_REGISTRY 中注册一行

  4. 在 life-saver-mcp.json 的 handlers 中添加配置（enabled: true 即自动生效）

开发

# 运行测试（106 tests）
pytest

# 代码检查
ruff check src tests

# 类型检查
mypy src/life_saver_mcp

参考项目

  • 蓝湖功能参考：lanhu-mcp — 蓝湖 Axure 文档提取 MCP Server，本项目的蓝湖 Handler（Axure 截图、设计标注、切图提取、DDS Schema 等）基于该项目的实现思路和 API 调用方式进行适配。

License

MIT

Install Server
F
license - not found
D
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Qase Test Management

    Official MCP server for Qase — manage test cases, runs, suites, defects via AI tools.

  • SmartBear MCP

    MCP server for AI access to SmartBear tools, including BugSnag, Reflect, Swagger, PactFlow, QTM4J.

  • BugEzy

    Voice-powered bug reporting with 13 MCP tools. Record bugs by talking; let AI find and fix them.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kaminof3tt/life-saver-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server