Reftrixmcp
Web design analysis with 26 MCP tools: layout, motion, quality, semantic search via pgvector
Connector by TKMD · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/tkmd-reftrixmcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 33 read · 3 write · 5 delete
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 41
Read from the source code; the running server may list different tools.
Read 33 · Look things up without changing anything.
accessibility.auditaudit.querybackground.searchbrief.validatedata.exportdesign.comparedesign.regression_testdesign.search_by_imagedesign.similar_siteembedding.qualitylayout.inspectlayout.search
Show 21 more tools
motion.analyze_framesmotion.detectmotion.searchnarrative.analyzenarrative.searchpage.getBatchStatuspage.getJobStatuspart.comparepart.inspectpart.searchperformance.evaluatepreference.getquality.evaluatereport.generateresponsive.captureresponsive.searchsearch.facetssearch.unifiedsection.inspectstyle.get_palettesystem.health
Write 3 · Create, change, send or run things.
layout.generate_codelayout.ingestpage.batch_analyze
Delete 5 · Delete, drop, revoke or wipe things.
data.deletedesign.track_changeslayout.batch_ingestpreference.hearpreference.reset
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
DATABASE_URL
Other settings (environment variables or headers).
OLLAMA_BASE_URLREDIS_URL
Network hosts it talks to 60
1-10.cc· found in codeactivetheory.net· found in codeakqa.com· found in codealejandromejias.com· found in codearamco.com· found in codearistidebenoist.com· found in codeartiomyakushev.com· found in codebaigie.me· found in codebaqemono.jp· found in codebasement.studio· found in codebasicagency.com· found in codebreakthroughenergy.org· found in codebrooklynorg.com· found in codebuttermax.net· found in codecaffe.design· found in codecdn.jsdelivr.net· found in codecdn.tailwindcss.com· found in codecekai.us· found in codeciridae.com· found in codeclementgrellier.com· found in codecydstumpel.nl· found in codedennissnellenberg.com· found in codedocs.reftrix.dev· found in codedogstudio.co· found in codedylanbrouwer.design· found in codeeatcreative.jp· found in codeedoardolunardi.dev· found in codeelliottmangham.com· found in codeemilieaubry.com· found in codeethanandtom.com· found in code
Show 30 more hosts
exoape.com· found in codeexploreprimland.com· found in codeflowfest.com· found in codefundamental.bg· found in codegarden-eight.com· found in codegithub.com· found in codeglama.ai· found in codeheydays.no· found in codeholographik.co· found in codehomunculus.jp· found in codehonda.co.jp· found in codehugeinc.com· found in codehuggingface.co· found in codeinfinite-wonderland.com· found in codejson.schemastore.org· found in codejstack.com.br· found in codekentuckybourbon.com· found in codekokuyo.com· found in codekprverse.com· found in codelanguageexplorer.app· found in codelbproject.dev· found in codelive.shopify.com· found in codelocomotive.ca· found in codelusion.co· found in codemakemepulse.com· found in codemalvah.com· found in codemaxmara.com· found in codemaxmilkin.com· found in codemediamonks.com· found in codereftrix.dev· found in code
Files it touches
/proc/meminfo/proc/self/environ/tmp/reftrix-css-analysis-cache/tmp/reftrix-embedding-cache/tmp/reftrix-frames/tmp/reftrix-webgl-frames/tmp/reftrix-worker-stderr/usr/local/lib/ollama/cuda_v12- Your home directory (~)
Tools (41)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
accessibility.auditAccessibility Auditread-onlyWCAG 2.1 accessibility audit using axe-core with contrast ratio checking. Analyzes HTML or URL for WCAG A/AA/AAA compliance, detects violations with severity classification, calculates accessibility score (0-100), and checks text/background contrast ratios.
audit.queryAudit Log Queryread-only監査ログを検索します。GDPR Art.30に基づく処理活動記録の閲覧。Query audit logs. View records of processing activities per GDPR Art.30.
background.searchBackground Searchread-onlyBackgroundDesignをセマンティック検索します。グラデーション、グラスモーフィズム、SVG背景等の背景デザインパターンを自然言語で検索できます。designType(14種類)やwebPageIdでフィルタリング可能です。
brief.validateBrief Validateread-onlyValidate design brief and return completeness score with improvement suggestions
data.deleteData Delete (GDPR Art.17)GDPR Art.17「忘れられる権利」/ CCPA §1798.105 に基づくデータ完全削除。page(全関連テーブルCASCADE DELETE)、profile(嗜好プロファイル完全削除)、all_user_data(全ユーザーデータ一括削除)から選択。confirm: true 必須。target=page / all_user_data では DB 削除前に embedding-backfill Queue の滞留ジョブ(7カテゴリ)も削除し、非同期 backfill による削除済みデータ復活を防止する。GDPR Art.17 / CCPA §1798.105 Right to Erasure. Permanently deletes all data for the specified target. Supports page (CASCADE DELETE), profile (hard delete), all_user_data (bulk delete). confirm: true is required. For target=page / all_user_data, embedding-backfill queue jobs (7 categories) are also removed before DB deletion to prevent a…
data.exportData Export (GDPR Art.20)read-onlyGDPR Art.20「データポータビリティの権利」に基づくデータエクスポート。指定されたpage/profileの全関連データをJSON形式でエクスポート。PII情報を明示的にマーキング。GDPR Art.20 Right to Data Portability. Exports all related data for the specified target in JSON format. PII fields are explicitly marked.
design.compareDesign Compareread-only2-5件のWebページをレイアウト・視覚・品質・カラーの4軸で比較し、ペアワイズ類似度スコア(0-1)を算出します。include_detailsで共通パターンと差分ポイントも取得可能。 / Compare 2-5 web pages across layout, visual, quality, and color dimensions. Returns pairwise similarity scores (0-1). Set include_details for common patterns and key differences.
design.regression_testVisual Regression Testread-onlyベースラインスナップショットと現在のWebページをPixelmatchでピクセルレベル比較し、閾値ベースのpass/fail判定を行います。diff画像(Base64 PNG)と変更ピクセル割合を返却します。design.track_changesのsnapshotアクションで保存したスナップショットをベースラインとして使用します。 / Pixel-level comparison between baseline snapshot and current web page via Pixelmatch. Returns threshold-based pass/fail, diff image (Base64 PNG), and change percentage. Use snapshots from design.track_changes snapshot action as baseline.
design.search_by_imageDesign Search by Imageread-only画像から視覚的に類似したデザインセクションを検索します。Base64エンコード画像またはHTTPS画像URLを入力として受け付けます。DINOv2 visual embeddingを使用したHNSW検索で類似デザインを発見します。オプションのテキストクエリを指定すると、RRF 3-source融合(text 40% + vision 30% + fulltext 30%)でハイブリッド検索を実行します。
design.similar_siteSimilar Site Searchread-onlyURLを入力として、DB内の類似デザインのWebサイトを検索します。指定URLのページのセクションembedding(DINOv2 vision + e5-base text)のmean poolingでページレベルの代表ベクトルを生成し、pgvector HNSW検索で類似サイトを発見します。RRF 3-source fusion(text 40% + vision 30% + fulltext 30%)で総合スコアを算出。 / Searches for similar website designs in DB given a URL. Generates page-level representative vectors via mean pooling of section embeddings (DINOv2 vision + e5-base text) and finds similar sites using pgvector HNSW search.
design.track_changesDesign Change Tracker同一URLのデザイン変更を時系列で追跡します。スナップショット保存、embedding diffによる変更検出、履歴管理、自動変更検出の4つのアクションを提供します。変更度スコア(0=同一、1=完全に異なる)とセクション単位の変更カテゴリ(added/removed/modified/unchanged)で変更を可視化します。 / Tracks design changes of the same URL over time. Provides 4 actions: snapshot (save), compare (embedding diff), history (list), detect (auto-detect). Visualizes changes with change score (0=identical, 1=completely different) and per-section categories (added/removed/modified/unchanged).
embedding.qualityEmbedding Quality Monitorread-onlyEmbedding品質を監視します。DINOv2/e5-baseのカバレッジ、異常検出、ドリフト検出を実行。Monitor embedding quality. Runs coverage, anomaly detection, and drift detection for DINOv2/e5-base.
layout.batch_ingestLayout Batch IngestBatch ingest multiple URLs for layout analysis. Processes URLs in parallel with configurable concurrency. Supports skip/abort modes for error handling.
layout.generate_codeLayout Generate CodeパターンからReact/Vue/Svelte/Astro/HTMLコードを生成します
layout.ingestLayout IngestFetch HTML/screenshot from URL for layout analysis. SSRF protection blocks private IPs/metadata services. HTML is sanitized.
Show 26 more tools
layout.inspectLayout Inspectread-onlyParse HTML and extract section structure, grid, typography info
layout.searchLayout Searchread-onlyレイアウトパターンをセマンティック検索します
motion.analyze_framesフレーム画像(PNG/JPEG連番)を解析し、モーション/アニメーションパターンを検出します。 対応する解析タイプ: - frame_diff: フレーム間のピクセルレベル変化を検出 - layout_shift: 予期しないレイアウト変化(CLS問題)を検出 - color_change: フェードイン/アウトなどの色・透明度変化を検出 - motion_vector: 移動方向と速度を推定 - element_visibility: 新規要素の出現や既存要素の消失を検出 入力: motion.detect の enable_frame_capture で生成されたフレーム画像ディレクトリ 出力: 解析結果(変化率、レイアウトシフトスコア、タイムライン等)
motion.detectMotion Detectread-onlyWebページからモーション/アニメーションパターンを検出・分類します。CSSアニメーション、トランジション、キーフレームを解析し、パフォーマンスやアクセシビリティの問題を警告します。
motion.searchMotion Searchread-onlyモーションパターンを類似検索、または実装コードを生成します。action: search(デフォルト)で検索、action: generateでCSS/JS実装コードを生成します。
narrative.analyzeURLまたはHTMLからWebデザインの世界観(WorldView)とレイアウト構成(LayoutStructure)を分析します。Vision LLMとCSS静的分析を組み合わせ、ムードカテゴリ・色彩印象・グリッドシステム・視覚的階層等を抽出します。DB-first設計: デフォルトでDB保存し、最小レスポンスを返却。
narrative.searchNarrative Searchread-only世界観・レイアウト構成でセマンティック検索します。自然言語クエリ(例: "サイバーセキュリティ感のあるダークなデザイン")または768次元Embeddingで検索可能。Hybrid Search(Vector + Full-text)でRRF統合。
page.batch_analyzeBatch Page AnalyzerBatch analyze multiple URLs in parallel. Submits all URLs as async BullMQ jobs and returns immediately with a batch ID. Features: - Up to 50 URLs per batch - Configurable concurrency (1-5, default: 3) - SSRF validation for all URLs before submission - Graceful degradation: individual failures don't affect the batch - Progress tracking via page.getBatchStatus - Rate limiting within analysis tier (10 RPM) Use page.getBatchStatus to poll for results.
page.getBatchStatusBatch Status Checkerread-onlyCheck the status of a batch analysis job submitted via page.batch_analyze. Returns: - Batch state (waiting, active, completed, failed, partial) - Progress percentage (0-100) - Summary (total, completed, failed, skipped counts) - Individual job results with states and webPageIds Use the batch_id returned by page.batch_analyze to query status.
page.getJobStatusPage Get Job Statusread-onlyCheck 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.comparePart Compareread-only2-5個のUIパーツをスタイル・レイアウト・インタラクション・アクセシビリティで並列比較。デフォルトはstyles+layout。各プロパティの同一性も判定。 / Compare 2-5 UI parts on styles, layout, interaction, and accessibility. Default: styles + layout. Reports property-level identity.
part.inspectPart Inspectread-only特定のUIコンポーネントパーツの詳細情報を取得します。スタイル、HTML、バウンディングボックス、インタラクション情報、Embedding有無等を返します。 / Inspect a specific UI component part by ID. Returns styles, HTML, bounding box, interaction info, embedding status, etc.
part.searchPart Searchread-onlyUIコンポーネントパーツ(ボタン、カード、リンク等)をセマンティック検索します。テキストクエリ(e5-base + full-text)によるハイブリッド検索を提供。partType(16種類)やsearchMode(visual/text/hybrid)でフィルタリング可能です。 / Search UI component parts (buttons, cards, links, etc.) by text query. Provides hybrid search via e5-base + full-text. Filterable by partType (16 types) and searchMode (visual/text/hybrid).
performance.evaluatePerformance Evaluateread-onlyEvaluate web page performance using Core Web Vitals (LCP, FID, CLS, INP, TTFB) via Playwright PerformanceObserver API. Returns a score (0-100), grade, and optional improvement recommendations.
preference.getPreference Getread-only現在の嗜好プロファイルを取得します。profile_id省略時はデフォルトプロファイルを返します。Get current preference profile. Returns default profile when profile_id is omitted.
preference.hearPreference Hearingユーザー嗜好ヒアリングセッション。feedbackなしでサンプル提示、feedbackありで嗜好プロファイル更新。User preference hearing session. Present samples without feedback, update profile with feedback.
preference.resetPreference Reset嗜好プロファイルをリセットします。confirm: trueが必須です。preference_signalsもCASCADE削除されます。Reset preference profile. confirm: true is required. preference_signals are CASCADE deleted.
quality.evaluateQuality Evaluateread-onlyEvaluate web design quality on 3 axes (originality, craftsmanship, contextuality) with AI cliche detection
report.generateReport Generatorread-only分析済みWebページのレポートをHTML(インタラクティブ)またはPDF(印刷用)形式で生成します。セクション構成、モーションパターン、品質スコア、スクリーンショットを集約したクライアント納品可能なレポートを出力します。 / Generates analysis reports in HTML (interactive) or PDF (printable) format. Aggregates sections, motion patterns, quality scores, and screenshots into a client-deliverable report.
responsive.captureResponsive Captureread-only3ビューポート(desktop 1920x1080, tablet 768x1024, mobile 375x812)でWebページを同時キャプチャし、レスポンシブレイアウトの差分を分析します。セクション表示/非表示、フォントサイズ変化、グリッドカラム変化、スペーシング変化を検出し、差分スコア(0-100)を返します。
responsive.searchResponsive Searchread-onlyレスポンシブデザイン分析結果をセマンティック検索します。ビューポート間の差異(レイアウト変化、ナビゲーション変化、表示切替等)を自然言語で検索できます。差異カテゴリ、ビューポートペア、ブレークポイント範囲、スクリーンショット差分率でフィルタリング可能です。
search.facetsFaceted Searchread-only[DEPRECATED: Use search.unified with include_facets: true instead] ファセット検索(絞り込みカウント表示)。検索結果をsectionType・industry・audience・tagsで分類し、各値の件数を返却します。検索結果の絞り込みUIやフィルタ選択に使用します。代替: search.unified({ query: '...', include_facets: true, facet_fields: ['sectionType'], enable_reranking: false, limit: 50 }) / Faceted search with filter counts. Classifies search results by sectionType, industry, audience, and tags, returning counts per value. Used for search result refinement UI and filter selection.
search.unifiedUnified Searchread-onlyLayout(セクション)・Part(UIコンポーネント)・Motion(アニメーション)・Background(背景デザイン)・Narrative(世界観)を横断的にセマンティック検索します。個別検索ツールを並列実行し、結果をsimilarityスコア順にマージして返却します。 / Cross-component semantic search across Layout sections, UI Parts, Motion patterns, Background designs, and Narratives. Executes individual search tools in parallel and merges results by similarity score.
section.inspectSection Inspectread-onlyセクションパターンIDからセクションのメタデータ(section_type / position 等)とサニタイズ済み構造プレビューを取得します。セクションハンドル reftrix:page/<id>/section/<id> の解決に使用します。high-PII セクションの構造は秘匿されます。 / Inspect a section by section_pattern_id. Returns section metadata (section_type, position, etc.) and a sanitized structure preview, for resolving a section handle reftrix:page/<id>/section/<id>. High-PII section structure is redacted.
style.get_paletteStyle Get Paletteread-onlyGet brand palette. Specify ID for details or no params for list. Includes OKLCH color values and gradient definitions.
system.healthSystem Healthread-onlyRun MCP server health check. Checks MCP tool metrics, embedding cache stats, service initialization status, pattern services health, and returns diagnostics.
Signals
- Stars
- 2
- Forks
- 0
- Open issues
- 0
- Last commit
- Oct 20, 2026 (9 days ago)
- Last release
- Oct 20, 2026 (9 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.TKMD/reftrixmcp- Version
- 0.1.8
- Auth
- API key
- Packages
- npm @reftrixmcp/mcp-server
- License
- AGPL-3.0
- Repository
- github.com/TKMD/ReftrixMCP
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Reftrixmcp MCP server. Agent Mart. https://agentmart.dev/connectors/tkmd-reftrixmcp (last updated 2026-10-24)