Reftrixmcp MCP server
io.github.TKMD/reftrixmcp·v0.1.8·2 starsWeb design analysis with 26 MCP tools: layout, motion, quality, semantic search via pgvector
2 stars32 downloads/wk
Reviews
Write oneNobody has reviewed Reftrixmcp yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Reftrixmcp tools (28, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
background.searchBackgroundDesignをセマンティック検索します。
brief.validateValidate design brief and return completeness score with improvement suggestions
layout.batch_ingestBatch ingest multiple URLs for layout analysis. Processes URLs in parallel with configurable concurrency. Supports skip/abort modes for error handling.
layout.generate_codeパターンからReact/Vue/HTMLコードを生成します
layout.ingestFetch HTML/screenshot from URL for layout analysis. SSRF protection blocks private IPs/metadata services. HTML is sanitized.
layout.inspectParse HTML and extract section structure, grid, typography info
layout.searchレイアウトパターンをセマンティック検索します
motion.analyze_framesフレーム画像(PNG/JPEG連番)を解析し、モーション/アニメーションパターンを検出します。 対応する解析タイプ: - frame_diff: フレーム間のピクセルレベル変化を検出 - layout_shift: 予期しないレイアウト変化(CLS問題)を検出 - color_change: フェードイン/アウトなどの色・透明度変化を検出 - motion_vector: 移動方向と速度を推定 - element_visibility: 新規要素の出現や既存要素の消失を検出 入力: motion.detect の enable_frame_capture で生成されたフレーム画像ディレクトリ 出力: 解析結果(変化率、レイアウトシフトスコア、タイムライン等)
motion.detectWebページからモーション/アニメーションパターンを検出・分類します。CSSアニメーション、トランジション、キーフレームを解析し、パフォーマンスやアクセシビリティの問題を警告します。
motion.searchモーションパターンを類似検索します。自然言語クエリまたはサンプルパターンを使用して、類似のアニメーション/トランジションパターンを検索できます。
narrative.analyzeURLまたはHTMLからWebデザインの世界観(WorldView)とレイアウト構成(LayoutStructure)を分析します。
narrative.search世界観・レイアウト構成でセマンティック検索します。
page.analyzeAnalyze a web page URL with layout detection, motion pattern extraction, and quality evaluation. Executes layout.ingest, motion.detect, and quality.evaluate in parallel and returns unified results.
page.getJobStatusCheck the status of an async page analysis job. Use this tool to poll for the status and results of a job that was submitted with page.analyze(async=true). Returns: - Job state (waiting, active, completed, failed) - Progress percentage (0-100) - Result summary when completed - Error details when failed Note: Requires Redis to be running. Jobs are retained for 24 hours after completion.
part.compare2-5個のUIコンポーネントパーツをスタイル・レイアウト・インタラクション・
part.inspect特定のUIコンポーネントパーツの詳細情報を取得します。
part.searchUIコンポーネントパーツ(ボタン、カード、リンク等)をセマンティック検索します。
preference.get現在の嗜好プロファイルを取得します。profile_id省略時はデフォルトプロファイルを返します。
preference.hearユーザー嗜好ヒアリングセッション。feedbackなしでサンプル提示、feedbackありで嗜好プロファイル更新。
preference.reset嗜好プロファイルをリセットします。confirm: trueが必須です。preference_signalsもCASCADE削除されます。
project.getGet project details by ID.
project.listList user projects. Supports status filter, pagination, sorting.
quality.batch_evaluate[DEPRECATED v0.1.0] 複数ページの品質を一括評価します。最大100件まで対応。
quality.evaluateEvaluate web design quality on 3 axes (originality, craftsmanship, contextuality) with AI cliche detection
quality.getJobStatusCheck the status of an async batch quality evaluation job. Use this tool to poll for the status and results of a job that was submitted with quality.batch_evaluate. Returns: - Job state (waiting, active, completed, failed) - Progress percentage (0-100) - Item counts (total, processed, success, failed) - Result summary when completed - Error details when failed Note: When Redis is unavailable, fall
responsive.searchレスポンシブデザイン分析結果をセマンティック検索します。
style.get_paletteGet brand palette. Specify ID for details or no params for list. Includes OKLCH color values and gradient definitions.
system.healthwrite actionRun MCP server health check. Checks MCP tool metrics, embedding cache stats, service initialization status, pattern services health, and returns diagnostics.
Public scan report
scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan958 source files scanned13/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 22 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- highShell command built from a string (injection risk)
exec.shell-concatsrc/services/browser-process-manager.ts: … デフォルト(pipe)のため、子プロセス出力は親に流れない。 execSync(`pkill -TERM -P ${this.browserPid} || true`); // …
How Reftrixmcp compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 65/100
- higher than 20% of 3,470 Web search servers
- Tools
- 28
- the typical Web search server has 5
- Tools that change things
- 4%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 70% of 1,786 Web search servers
- Downloads a week
- 32
- more than 18% of 827 Web search servers with a package
What its tools let an agent do: 25 read · 1 create · 1 change · 1 run or deploy
Install Reftrixmcp in Claude Code, Cursor or VS Code
Runs npx -y @reftrixmcp/mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add reftrixmcp -- npx -y @reftrixmcp/mcp-server
What the publisher says
From the Reftrixmcp repository's README, as published. We do not edit it. Read it on GitHub
ReftrixMCP
Web design knowledge base platform -- layout analysis, motion detection, and quality evaluation via MCP tools.
For frontend engineers, designers, and AI-agent builders who want to analyze real websites and retrieve reusable UI patterns via Claude or any MCP client.
Japanese / 日本語の概要
ReftrixMCPは、Webデザインパターンをベクトル検索(pgvector HNSW)と RAGで検索可能なナレッジベースに集約し、MCPツール経由でClaude等の AIエージェントと統合するプラットフォームです。
主要機能: レイアウト分析 / モーション検出 / 品質評価 / セマンティック検索 / 横断検索 / 画像類似検索 / レスポンシブ解析 / 嗜好プロファイリング / パーツ分析 / レート制限 / 検索キャッシュ / BullMQ UI / SBOM
<!-- gen:tool-count -->40<!-- /gen:tool-count -->のMCPツールを提供: Layout(5) / Motion(2) / Quality(1) / Page(4) / Narrative(1) / Background(1) / Responsive(2) / Preference(3) / Part(3) / Style(1) / Brief(1) / System(1) / Search(2) / Design(5) / Data(2) / Audit(1) / Embedding(1) / Accessibility(1) / Performance(1) / Report(1)
詳細な日本語ドキュメント: docs/README.ja.md
What it does
- Layout analysis -- auto-detect sections (hero, feature, CTA, etc.), extract grid/typography, and generate React/Vue/HTML code
- Motion detection -- discover CSS/JS animations with frame capture (15 px/frame video mode), CLS detection via Pixelmatch
- Quality evaluation -- score designs on three axes (originality, craftsmanship, contextuality) with anti-AI-cliche detection
- Semantic search -- find layout, motion, narrative, background, and responsive patterns via pgvector HNSW hybrid search
- Preference profiling -- learn user design preferences through feedback sessions and personalize search results via reranking (GDPR-compliant)
- Part-level analysis -- extract 16 UI part types (button, icon, heading, etc.) with DINOv2 visual embeddings for visual similarity search
- Vision integration -- Ollama llama3.2-vision for richer layout, motion, and narrative understanding
- Section post-processing -- auto merge/split sections by type, heading, and height (Rule 1-4) for optimal structure
- Multi-tile capture -- split large sections (>viewport height) into tiles for complete DINOv2 visual coverage
- Blank image detection -- detect lazy-loading unrendered sections and re-capture via Playwright for full coverage
- Code generation -- convert analyzed sections to React, Vue, or plain HTML with matched motion patterns
- Unified search -- cross-service search across layout, part, motion, background, and narrative patterns in a single query
Why ReftrixMCP
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Reftrixmcp: common questions
- Is Reftrixmcp MCP server safe?
- With care: it is graded C, so read the findings first (65/100). Read the Reftrixmcp safety report
- How do I install Reftrixmcp?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Reftrixmcp need an API key?
- Yes. The registry entry asks for
DATABASE_URL. - Is Reftrixmcp maintained?
- The last commit was 59 days ago (2026-09-06). The latest release is v0.1.8.
- What can I use instead of Reftrixmcp?
- Servers from other publishers that do the same job: Zotero MCP server, Perplexity API Platform (moved to ai.perplexity/mcp-server) and Arxiv MCP server.
- How does Reftrixmcp compare with other Web search MCP servers?
- safety score 65/100 (higher than 20% of 3,470 Web search servers); tools 28 (the typical Web search server has 5); tools that change things 4% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Reftrixmcp
Same job from other publishers: the closest match first, then the best rated.
Zotero MCPSearch, read, annotate, and add to your Zotero research library, local or web.not reviewedWidely usedB- Perplexity API Platform (moved to ai.perplexity/mcp-server)Real-time web search, reasoning, and research through Perplexity's APInot reviewedWidely usedA
- ArxivSearch arXiv papers, download full text, semantic search, citation graphs, and alerts via MCP.not reviewedWidely usedA
- TavilyMCP server for advanced web search using Tavilynot reviewedWidely usedA
- SearchMCP server for web search operationsnot reviewedEstablishedA