Reftrixmcp MCP Server

Web design analysis with 26 MCP tools: layout, motion, quality, semantic search via pgvector

Local serverstdio

What is the Reftrixmcp MCP Server?

Web design analysis with 26 MCP tools: layout, motion, quality, semantic search via pgvector

What the server does

ReftrixMCPは、Webデザインパターンをベクトル検索(pgvector HNSW)と RAGで検索可能なナレッジベースに集約し、MCPツール経由でClaude等の AIエージェントと統合するプラットフォームです。

  • 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

Credentials and setup notes

Node.js 20+, pnpm 10+, Docker & Docker Compose, Ollama

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
layout.ingest- fetch a web page, take a screenshot, and extract section patterns
layout.search- semantic search over layout sections by natural-language query
motion.detect- detect CSS/JS animations with video-mode frame capture
quality.evaluate- score design quality on originality, craftsmanship, and contextuality
page.analyze- unified analysis: layout + motion + quality + responsive in one call (async via BullMQ), with opt-in Phase 7.5: accessibility audit, performance evaluation, and auto snapshot
responsive.search- search responsive analysis results by viewport and breakpoint
preference.hear- interactive preference hearing sessions with sample presentation and feedback collection
preference.get- retrieve preference profiles (with GDPR data portability support)
preference.reset- reset or permanently delete preference profiles (GDPR Right to Erasure)
part.search- semantic search over UI parts with visual (DINOv2) or text embeddings
part.inspect- get detailed part info including computed styles, bounding box, and accessibility
part.compare- compare 2-5 parts side by side on styles, layout, and interaction

How to install the Reftrixmcp MCP Server

{
  "mcpServers": {
    "reftrix": {
      "command": "node",
      "args": ["/absolute/path/to/ReftrixMCP/apps/mcp-server/dist/index.js"],
      "env": {
        "NODE_ENV": "development",
        "DATABASE_URL": "postgresql://reftrix:change_me@localhost:26432/reftrix?schema=public",
        "REDIS_URL": "redis://localhost:27379",
        "OLLAMA_BASE_URL": "http://localhost:11434",
        "OLLAMA_HOST": "http://localhost:11434",
        "ENABLE_SECTION_SCREENSHOT_FALLBACK": "true"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Node.js 20+, pnpm 10+, Docker & Docker Compose, Ollama

VariableDescriptionRequired
DATABASE_URLEndpoint or connection string the server talks to.Yes
REDIS_URLEndpoint or connection string the server talks to.Yes
OLLAMA_BASE_URLEndpoint or connection string the server talks to.Yes
OLLAMA_HOSTEndpoint or connection string the server talks to.Optional
ENABLE_SECTION_SCREENSHOT_FALLBACKConfiguration value read at startup.Optional
DINOV2_MODEL_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Reftrixmcp to layout.ingest.”
  • “Use Reftrixmcp to layout.search.”
  • “Use Reftrixmcp to motion.detect.”

Frequently asked questions

Web design analysis with 26 MCP tools: layout, motion, quality, semantic search via pgvector Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.