Skip to main content
Glama
ReftrixMCP
by TKMD

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NODE_ENVYesNode environment (development, production, test)
REDIS_URLNoRedis connection URL
DATABASE_URLYesPostgreSQL connection URL
OLLAMA_BASE_URLNoOllama 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

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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:

  • job_id: the job ID returned by page.analyze(async=true)

  • batch_id: the batch ID returned by page.batch_analyze

Returns for job_id:

  • Job state (waiting, active, completed, failed)

  • Progress percentage (0-100)

  • Result summary when completed

  • Error details when failed

Returns for batch_id:

  • Batch state (waiting, active, completed, failed, partial)

  • Progress percentage (0-100)

  • Summary (total, completed, failed, skipped counts)

  • Individual job results with states and webPageIds

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:

  • 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.getJobStatus(batch_id)

  • Rate limiting within analysis tier (10 RPM)

Use page.getJobStatus with batch_id to poll for results.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 27 tools

Disambiguation3/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessLimited data