pudge-ui — Claude Code MCP server: what it does, how to install
Provides coding assistants with specs for 93 skeuomorphic 2000s-style components from pudge-ui. Useful when building retro interfaces without copy-pasting styling docs.
claude mcp add pudge-ui -- npx -y @pudge-ui/mcp-serverWhat pudge-ui does
This server gives your coding assistant direct access to 93 component blueprints from the pudge-ui system. An agent discovers controls via fuzzy lookup with search_components or category filters through list_components. Foundation documents arrive via get_foundation. When assembling multi-part panels, it pulls combined data via get_composition.
Every spec file ships bundled inside the @pudge-ui/mcp-server distribution. Operations run in read-only mode, avoiding external network traffic and filesystem modifications. Because the package is pre-1.0, pinning an exact release in your client configuration prevents unexpected breaks across updates.
What it helps with
- retrieve skeuomorphic design specs for 2000s retro UI elements
- feed pudge-ui foundation style guidelines into agent context
- inspect multi-element setups such as audio mixer strips
- search component docs by keyword without browsing a web catalog
Example prompts for the agent
- Search for audio sliders with
search_componentsand fetch specs forvu-meter. - Pull extended foundation guidelines via
get_foundationand plan a retro control panel. - Get the complete specification for the
audio-mixer-stripcomposition.
How to install pudge-ui
Platform CLI
claude mcp add pudge-ui -- npx -y @pudge-ui/mcp-serverPlatform CLI
codex mcp add mcp-server -- npx -y @pudge-ui/mcp-serverConfig file
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@pudge-ui/mcp-server"
]
}
}
}Config file
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@pudge-ui/mcp-server"
]
}
}
}Platform CLI
gemini mcp add mcp-server npx -y @pudge-ui/mcp-serverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about pudge-ui
How do I install pudge-ui in Claude Code?
Run claude mcp add pudge-ui -- npx -y @pudge-ui/mcp-server in your terminal.
What does pudge-ui do?
It queries 93 component specifications from the pudge-ui design catalog, delivering retro interface specs directly into agent prompts.
Does pudge-ui write files or require internet access during queries?
No, all component data is bundled locally within the npm package. Each tool carries a readOnlyHint, ensuring no outbound requests or disk modifications occur.
