Nostalgiaui
MCP server giving coding agents NostalgiaUI era tokens, component code and contrast checks
- 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/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"nostalgiaui": {
"command": "npx",
"args": [
"-y",
"@nostalgiaui/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"nostalgiaui": {
"command": "npx",
"args": [
"-y",
"@nostalgiaui/mcp"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory