Reftrixmcp

Name: Reftrixmcp
Author: TKMD

@TKMD

About Reftrixmcp

MCP server with 39 tools for web design analysis — layout extraction, motion detection, quality scoring, accessibility audit, Core Web Vitals, design comparison, and semantic search via Playwright, pgvector, ONNX Runtime, and Ollama.

#mcp-server #web-design #layout-analysis #motion-detection #semantic-search #pgvector #playwright #ollama #typescript #responsive-design

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "reftrix": {
      "command": "node",
      "args": [
        "/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"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is ReftrixMCP?

ReftrixMCP is a web design knowledge base platform that provides layout analysis, motion detection, and quality evaluation via MCP tools. It is built for frontend engineers, designers, and AI‑agent builders who want to analyze real websites and retrieve reusable UI patterns through Claude or any MCP client. The system uses PostgreSQL 18 with pgvector for vector search, Redis for caching and job queues, and ONNX Runtime for multilingual and visual embeddings.

How to use ReftrixMCP?

Clone the repository, install dependencies with pnpm, set up Docker containers for PostgreSQL and Redis, run database migrations and seed, build the project, install Playwright and download the DINOv2 and e5‑base models, then configure the MCP server in your Claude or MCP client config. Start the server with the command node /path/to/ReftrixMCP/apps/mcp-server/dist/index.js and provide environment variables for database, Redis, and Ollama.

Key features of ReftrixMCP

Layout analysis: auto‑detect sections and generate React/Vue/HTML code
Motion detection: discover CSS/JS animations with frame capture and CLS detection
Quality evaluation: score designs on originality, craftsmanship, and contextuality
Semantic search: pgvector HNSW hybrid search for layout, motion, and more
Preference profiling: learn user design preferences via feedback and reranking (GDPR‑compliant)
Part‑level analysis: extract 16 UI part types with DINOv2 visual embeddings

Use cases of ReftrixMCP

Analyze a web page’s layout, motion, and quality in a single async call (page.analyze)
Search for UI patterns across multiple sites by natural‑language query
Compare UI parts side by side (styles, layout, interaction) with part.compare
Generate code for detected sections (React, Vue, plain HTML)
Personalize design recommendations based on user preference profiles

FAQ from ReftrixMCP

What dependencies are required to run ReftrixMCP?

Node.js 20+, pnpm 10+, Docker & Docker Compose, Ollama (configured with llama3.2‑vision), PostgreSQL 18 with pgvector, Redis 7, and Playwright for browser crawling. ML features require onnxruntime‑node (optional dependency).

Does ReftrixMCP store any user data?

Preference profiles are stored and can be retrieved, reset, or deleted (GDPR Right to Erasure). Data lives in PostgreSQL and Redis. The system is GDPR‑compliant.

What transport does the MCP server use?

It uses the stdio transport. No HTTP or authentication is described in the README.

Are there any known limitations?

The onnxruntime‑node package is an optional dependency—ML tools (embedding, visual search) require explicit installation. Non‑ML tools (layout analysis, motion detection) work without it. The server requires a local Ollama instance for vision tasks.

Comments

More Other MCP servers

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K