# Nostalgiaui

> Nostalgiaui is an open-source MCP server for design and media. MCP server giving coding agents NostalgiaUI era tokens, component code and contrast checks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://nostalgiaui.sylvester.works
- **Repository:** https://github.com/sylvesterworks/nostalgia-ui/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.sylvesterworks/nostalgiaui
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

NostalgiaUI is a design system that renders an interface in the style of a past design era, with colours taken from popular VS Code themes. This server lets a coding agent pull the real tokens and component code instead of guessing. Asking for a settings page in Frutiger Aero with the Nord palette returns the actual values.

The design system keeps two independent axes. An era controls shape and feel: radius, borders, bevels, shadows, gradients, typography, density and motion. A palette controls colour only, so any palette works in any era; the site mentions 8 eras and 5 palettes.

get_component returns the import line, era-specific CSS, a props table extracted from the TypeScript types and a structured doc covering anatomy, patterns, accessibility and notes for the requested era. Passing a section, such as accessibility, returns only that part. The server runs over stdio from the npm package @nostalgiaui/mcp and is MIT licensed.

## Features

- **Era and palette listing:** list_eras and list_palettes show what an agent can pick from.
- **Design tokens:** get_tokens returns the tokens for a chosen era and palette.
- **Component source and docs:** get_component returns source, era CSS, a props table and structured guidance.
- **Section filtering:** Ask for one part of a component doc, such as accessibility.
- **VS Code theme import:** import_vscode_theme turns a VS Code theme into a palette.
- **Contrast checks:** check_contrast runs WCAG contrast checks on colour pairs.

## Good for

- Build a settings page in a retro era with a chosen palette
- Get accessible component source without guessing props
- Bring a favourite VS Code theme into a UI
- Check text and background contrast in a retro theme

## Install

### Claude Code (Terminal)

```sh
claude mcp add nostalgiaui -- npx -y @nostalgiaui/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nostalgiaui": {
      "command": "npx",
      "args": [
        "-y",
        "@nostalgiaui/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "nostalgiaui": {
      "command": "npx",
      "args": [
        "-y",
        "@nostalgiaui/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "nostalgiaui": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nostalgiaui/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "nostalgiaui": {
      "command": "npx",
      "args": [
        "-y",
        "@nostalgiaui/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "nostalgiaui": {
      "command": "npx",
      "args": [
        "-y",
        "@nostalgiaui/mcp"
      ]
    }
  }
}
```

## Tools

- `list_eras`: List the available design eras
- `list_palettes`: List the available colour palettes
- `get_tokens`: Get design tokens for an era and palette
- `get_component`: Get component source, era CSS, props table and docs
- `import_vscode_theme`: Import a VS Code theme as a palette
- `check_contrast`: Check colour contrast

## FAQ

### How do I add it to Claude Code?

Run claude mcp add --transport stdio nostalgiaui -- npx -y @nostalgiaui/mcp.

### Which licence applies?

The README says MIT.

### Is the component library on npm?

The site says the packages are not on npm yet, so you clone the repo and use the workspace until they are.

### Does an era set colours?

No. An era sets shape and feel, and a palette sets colour only.

### Is Nostalgiaui free?

Yes. Nostalgiaui is open source, so you can use and self-host it for free.

### How do I add Nostalgiaui to Claude Code?

Run this command in your terminal: claude mcp add nostalgiaui -- npx -y @nostalgiaui/mcp

### What are the best alternatives to Nostalgiaui?

The closest alternatives to Nostalgiaui are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/nostalgiaui
