用途
ReftrixMCP 是一个 Web 设计知识库平台，面向前端工程师、设计师和 AI 智能体开发者，用于分析真实网站并检索可复用的 UI 模式。它作为 MCP 服务器运行，可与 Claude 或任意 MCP 客户端集成，把网页转化为结构化、可向量检索的设计知识。
主要能力
- 布局分析（Layout）：自动检测区块类型（hero、feature、CTA 等），提取网格/排版信息，并可生成 React、Vue 或纯 HTML 代码。
- 动效检测（Motion）：发现 CSS/JS 动画，支持帧捕获（15 px/frame 视频模式），通过 Pixelmatch 进行 CLS 检测。
- 质量评估（Quality）：从原创性、工艺、情境性三个维度对设计打分，并含反 AI 陈词滥调检测。
- 语义搜索：基于 pgvector HNSW 混合搜索，查找布局、动效、叙事、背景和响应式模式。
- 偏好画像：通过反馈会话学习用户设计偏好，并通过重排序个性化搜索结果（符合 GDPR）。
- 部件级分析：提取 16 种 UI 部件类型（按钮、图标、标题等），使用 DINOv2 视觉嵌入支持视觉相似搜索。
- 响应式分析：按视口与断点检索响应式分析结果。
- 可选阶段：page.analyze 支持可选的 Phase 7.5，包括无障碍审计、性能评估与自动快照。
使用方式
通过 MCP 客户端（如 Claude Desktop）连接。在 MCP 配置中添加服务器，例如 macOS 下 Claude Desktop 的 ~/Library/Application Support/Claude/claude_desktop_config.json，或在项目根目录使用 .mcp.json。配置中需替换密码占位符，说明文档提示端口 26432 为标准 5432 加 21000 偏移。环境变量如 OLLAMA_BASE_URL、OLLAMA_HOST 需要一致；ENABLE_SECTION_SCREENSHOT_FALLBACK 可启用分段截图回退。多个可选环境变量有默认值（如 MAX_TILES_PER_SECTION、BLANK_IMAGE_STDDEV_THRESHOLD、DINOV2_MODEL_PATH 等）。
工具示例
共提供 40 个 MCP 工具，关键示例包括：layout.ingest（抓取网页、截图并提取区块模式）、layout.search（自然语言语义搜索布局区块）、motion.detect（动效检测）、quality.evaluate（设计质量评分）、page.analyze（统一分析，异步 BullMQ）、responsive.search、preference.hear/preference.get/preference.reset、part.search/part.inspect/part.compare 等。完整工具参考见 MCP Tools Guide。
适用场景
前端工程师复用 UI 模式、设计师分析竞品设计、AI 智能体开发者构建基于设计知识库的自动化流程。
限制
- 依赖 Node.js 20+、pnpm 10+、Docker & Docker Compose、Ollama。
- onnxruntime-node 为可选依赖；若安装失败或使用 --no-optional，非 ML 工具仍可用。
- CPU 模式嵌入每段文本约 2-5 秒，批量工作建议 GPU。
- 最低 16 GB RAM，建议 32 GB 以支持与 Ollama Vision 并发分析。
- 首次嵌入调用会下载约 1.1 GB ONNX 模型（multilingual-e5-base），DINOv2 视觉嵌入模型另需约 330 MB（ViT-B/14 ONNX）。
- 视觉分析（布局、动效、叙事）需要本地运行 Ollama + llama3.2-vision。
- page.analyze worker 在 MCP 服务器启动时由 WorkerSupervisor 自动 fork；手动启动仅限开发人员（需要 REFTRIX_ALLOW_MANUAL_WORKER=true）。
- 采用 AGPL-3.0-only 许可，网络使用需按第 13 条披露源代码；商业许可联系 licence@reftrix.io。
