Skip to content
MCP server

Nostalgiaui

MCP server giving coding agents NostalgiaUI era tokens, component code and contrast checks

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.3
Listing updated
2 days ago

About Nostalgiaui

Nostalgiaui is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nostalgiaui": {
      "command": "npx",
      "args": [
        "-y",
        "@nostalgiaui/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nostalgiaui": {
      "command": "npx",
      "args": [
        "-y",
        "@nostalgiaui/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Prices change. Check nostalgiaui.sylvester.works before you buy.

Nostalgiaui 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 to Nostalgiaui

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory