ReftrixMCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NODE_ENV | Yes | Node environment (development, production, test) | |
| REDIS_URL | No | Redis connection URL | |
| DATABASE_URL | Yes | PostgreSQL connection URL | |
| OLLAMA_BASE_URL | No | Ollama API URL |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| system.healthA | Run MCP server health check. Checks MCP tool metrics, embedding cache stats, service initialization status, pattern services health, and returns diagnostics. |
| layout.inspectB | Parse HTML and extract section structure, grid, typography info |
| layout.ingestA | Fetch HTML/screenshot from URL for layout analysis. SSRF protection blocks private IPs/metadata services. HTML is sanitized. |
| layout.searchB | セクションパターンを自然言語クエリでセマンティック検索します。日本語・英語の両方に対応しています。hero、feature、cta、testimonial、pricing、footer等のセクションタイプでフィルタリングできます。use_vision_search=trueでvision_embeddingを使用したハイブリッド検索(RRF: 60% vision + 40% text)が可能です。 |
| layout.generate_codeA | セクションパターンからReact/Vue/Svelte/Astro/HTMLコードを生成します。パターンIDを指定して、選択したフレームワーク(React, Vue, Svelte, Astro, HTML)でコードを出力できます。TypeScript/JavaScript、Tailwind CSS/Vanilla CSSの選択も可能です。 |
| quality.evaluateC | Evaluate web design quality on 3 axes (originality, craftsmanship, contextuality) with AI cliche detection |
| motion.detectC | Detect/classify motion patterns from web page. Parses CSS animations, transitions, keyframes. Warns about performance/accessibility issues. |
| motion.searchA | モーションパターンを類似検索、または実装コードを生成します。action: search(デフォルト)で検索、action: generateでCSS/JS実装コードを生成します。 |
| page.analyzeA | Analyze 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. Supports MCP streaming progress via _meta.progressToken for real-time phase notifications. |
| page.getJobStatusA | Check the status of an async page analysis job or of a batch. Pass exactly one of:
Returns for job_id:
Returns for batch_id:
Note: Requires Redis to be running. Jobs are retained for 24 hours after completion; batches for 48 hours. |
| narrative.searchB | 世界観・レイアウト構成でセマンティック検索します。自然言語クエリ(例: "サイバーセキュリティ感のあるダークなデザイン")または768次元Embeddingで検索可能。Hybrid Search(Vector + Full-text)でRRF統合。 |
| background.searchA | BackgroundDesignをセマンティック検索します。グラデーション、グラスモーフィズム、SVG背景等の背景デザインパターンを自然言語で検索できます。designType(14種類)やwebPageIdでフィルタリング可能です。 |
| responsive.searchA | レスポンシブデザイン分析結果をセマンティック検索します。ビューポート間の差異(レイアウト変化、ナビゲーション変化、表示切替等)を自然言語で検索できます。差異カテゴリ、ビューポートペア、ブレークポイント範囲、スクリーンショット差分率でフィルタリング可能です。 |
| part.searchB | UIコンポーネントパーツ(ボタン、カード、リンク等)をセマンティック検索します。テキストクエリ(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). |
| part.inspectA | 特定のUIコンポーネントパーツの詳細情報を取得します。スタイル、HTML、バウンディングボックス、インタラクション情報、Embedding有無等を返します。 / Inspect a specific UI component part by ID. Returns styles, HTML, bounding box, interaction info, embedding status, etc. |
| part.compareB | 2-5個のUIパーツをスタイル・レイアウト・インタラクション・アクセシビリティで並列比較。デフォルトはstyles+layout。各プロパティの同一性も判定。 / Compare 2-5 UI parts on styles, layout, interaction, and accessibility. Default: styles + layout. Reports property-level identity. |
| search.unifiedA | Layout(セクション)・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. |
| design.search_by_imageA | 画像から視覚的に類似したデザインセクションを検索します。Base64エンコード画像またはHTTPS画像URLを入力として受け付けます。DINOv2 visual embeddingを使用したHNSW検索で類似デザインを発見します。オプションのテキストクエリを指定すると、RRF 3-source融合(text 40% + vision 30% + fulltext 30%)でハイブリッド検索を実行します。 |
| design.similar_siteA | URLを入力として、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.compareA | 2-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. |
| audit.queryB | 監査ログを検索します。GDPR Art.30に基づく処理活動記録の閲覧。Query audit logs. View records of processing activities per GDPR Art.30. |
| data.deleteA | 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 async backfill from resurrecting erased data. |
| data.exportA | GDPR 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. |
| accessibility.auditA | WCAG 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. |
| performance.evaluateA | Evaluate 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. |
| responsive.captureA | 3ビューポート(desktop 1920x1080, tablet 768x1024, mobile 375x812)でWebページを同時キャプチャし、レスポンシブレイアウトの差分を分析します。セクション表示/非表示、フォントサイズ変化、グリッドカラム変化、スペーシング変化を検出し、差分スコア(0-100)を返します。 |
| page.batch_analyzeA | Batch analyze multiple URLs in parallel. Submits all URLs as async BullMQ jobs and returns immediately with a batch ID. Features:
Use page.getJobStatus with batch_id to poll for results. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 27 tools
Most tools map to distinct resource+action pairs, but there is substantial overlap: search.unified duplicates the seven individual *.search tools, design.search_by_image overlaps design.similar_site, and page.analyze re-runs layout.ingest, motion.detect and quality.evaluate. Descriptions help disambiguate, but an agent must decide between the orchestrator, the batch/async path, and the primitive tools, which creates real misselection risk.
Almost all tools use a consistent namespace.verb_noun pattern (layout.ingest, motion.detect, part.compare, data.delete). The main deviation is page.getJobStatus, which uses camelCase while siblings like page.batch_analyze use snake_case, breaking the otherwise predictable convention.
At 27 tools the surface is heavy for a web-design analysis server, and several tools are redundant (search.unified subsumes the per-resource searches, page.analyze subsumes the analysis primitives). It exceeds the 25-tool threshold where each tool no longer clearly earns its place.
The domain (web design analysis) is well covered: ingestion, layout/motion/responsive detection, semantic search across sections/parts/backgrounds/narratives, code generation, quality/accessibility/performance evaluation, comparison, and GDPR export/delete with audit logging. Minor gaps exist around pattern update/mutation and there is redundancy rather than missing lifecycle coverage.