# Refy

Refy — an MCP server for Claude Code that lets the agent search design system components, inspect APIs, and validate code against the real library.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13 repo stars
- Author: viniciuscoimbra
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/viniciuscoimbra/refy-design
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/refy

## What it does

Refy connects the AI agent to a React and TypeScript component library. The server provides eight tools to search components by description, inspect APIs, validate code, and generate themes with AA contrast. Running the tools requires Node.

The package handles multilingual component queries, checks code against rules, and compares visual layouts. A remote server at `https://refy.design/mcp` supports the first seven tools without reading local files.

## Requirements
- Remote server: `https://refy.design/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http refy https://refy.design/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add refy --url https://refy.design/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "refy": {
            "url": "https://refy.design/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "refy": {
            "type": "http",
            "url": "https://refy.design/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http refy https://refy.design/mcp
```

## When to use it
- find a UI component by natural language description
- validate screen code against the real component API
- generate and check themes with AA contrast
- compare original screenshots with implemented screens

## Example prompts
- Find a data table component in refy
- Check `src/Screen.tsx` against refy API rules
- Generate a new theme using refy

## Similar
- [design-system-compound-components](https://affpapa.org/en/nevibecode/rules/design-system-compound-components.md) — rule · ★ 88 repo stars
- [frontend-designer](https://affpapa.org/en/nevibecode/skills/frontend-designer.md) — skill · 345 installs
- [shadcn-ui](https://affpapa.org/en/nevibecode/skills/jezweb-shadcn-ui.md) — skill · 3600 installs
- [components-build](https://affpapa.org/en/nevibecode/skills/components-build.md) — skill · ★ 141 repo stars
- [react-component-architecture](https://affpapa.org/en/nevibecode/skills/react-component-architecture.md) — skill · 687 installs
- [tailwind-design-system](https://affpapa.org/en/nevibecode/skills/giuseppe-trisciuoglio-tailwind-design-system.md) — skill · 4800 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
