Model Context Protocol (MCP) Server: io.github.pudge-studio/pudge-ui

This MCP server provides programmatic access to the pudge-ui design system for coding agents. It enables agents to query component specifications described as “93 skeuomorphic 2000s-era UI component specs,” using the server’s available tools.

🛠️ Key Features

Query pudge-ui component specs via an MCP server
Covers 93 skeuomorphic 2000s-era UI component specifications
Includes context oriented around UI design system components

🚀 Use Cases

Retrieve coding-agent context for pudge-ui UI component specs
Reference 2000s skeuomorphic design-system details during implementation
Use design-system knowledge when generating or reviewing UI code

⚡ Developer Benefits

Tool-based access to component specs through MCP
Suitable for integration with MCP clients (e.g., Claude Desktop, Claude Code)
Supports local development by running the server via provided configuration

⚠️ Limitations

Description and readme excerpt only indicate spec querying; specific tool names and outputs are not included in the provided data

Related Topics

2000s, agent, coding, design-systems, llm, skeumorphic, ui

Installation

Add to your MCP client config (e.g. Claude Desktop, Claude Code):

json

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

For local development:

json

{
  "mcpServers": {
    "pudge-ui": {
      "command": "npx",
      "args": ["tsx", "src/index.ts"],
      "cwd": "/path/to/pudge-ui/packages/mcp-server"
    }
  }
}

Available Tools

Tool

Description

list_components

List all components, optionally filtered by category

search_components

Fuzzy search components by name, description, or tags

get_foundation

Get foundation spec docs (core 5 or extended 9)

get_component

Get full spec for a single component (foundation + spec)

get_components

Get specs for multiple components (foundation included once)

get_composition

Get a composition spec with all referenced component specs

Examples

code

list_components({ category: "buttons" })
search_components({ query: "volume slider audio" })
get_component({ name: "push-button" })
get_components({ names: ["rotary-encoder", "vu-meter", "vertical-fader"] })
get_composition({ name: "audio-mixer-strip" })
get_foundation({ extended: true })

All tools are read-only (annotated with readOnlyHint) — the server never writes to your filesystem or makes network calls. Specs are bundled in the package.

Versioning & stability

This server tracks pudge-ui's versioning and is pre-1.0. The component catalog grows between releases, but tool names and input shapes are stable — any change to a tool signature will come with a minor/major version bump and a CHANGELOG entry. Pin a version if you need byte-for-byte reproducibility.

io.github.pudge-studio/pudge-ui

Model Context Protocol (MCP) Server: io.github.pudge-studio/pudge-ui

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Related Topics

Topics

@pudge-ui/mcp-server

Installation

Available Tools

Examples

Development

Versioning & stability

Install

Related servers