Pudge Ui

io.github.pudge-studio由 GitHub 帳號 pudge-studio 發布v0.2.0更新於 Oct 24, 2026

Query pudge-ui — 93 skeuomorphic 2000s-era UI component specs — for coding-agent context.

已驗證STDIO僅桌面知識與記憶開發者工具

概覽

AI 產生的概覽

讓程式編寫助理查詢 pudge-ui 設計系統中 93 個 2000 年代擬物風格 UI 元件的規格。

可以做什麼
以唯讀工具的形式向程式編寫代理提供 pudge-ui 元件目錄。工具包括 list_components（可依類別篩選）、search_components（依名稱、描述或標籤模糊搜尋）、get_component 與 get_components（取得完整規格）、get_foundation（取得核心或延伸基礎文件），以及 get_composition（取得組合規格及其引用的所有元件規格）。規格隨套件內附，查詢在本機完成。
適用情境
當助理使用 pudge-ui 設計系統建置或修改介面，需要準確的元件名稱、屬性與組合資訊而非憑空猜測時適用。也適合在挑選元件前依類別瀏覽目錄或進行模糊搜尋。
執行需求
以 npm 套件 @pudge-ui/mcp-server 透過 stdio 在本機執行，通常以 npx 啟動。未宣告驗證、環境變數或標頭；規格隨套件提供，不需要網路存取。僅支援桌面端，不提供網頁可執行版本。
安裝前請注意
README 說明所有工具皆為唯讀，伺服器不會寫入檔案系統或發出網路請求。專案處於 1.0 之前的版本，元件目錄會隨版本增加，若需要可重現的輸出請固定版本。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Pudge Ui，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@pudge-ui/mcp-server

MCP server for the pudge-ui design system. Lets coding agents query component specs programmatically.

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

ToolDescription
list_componentsList all components, optionally filtered by category
search_componentsFuzzy search components by name, description, or tags
get_foundationGet foundation spec docs (core 5 or extended 9)
get_componentGet full spec for a single component (foundation + spec)
get_componentsGet specs for multiple components (foundation included once)
get_compositionGet a composition spec with all referenced component specs

Examples

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.

Development

bash
npm installnpm run dev        # run with tsxnpm run build      # compile + copy specnpm run typecheck  # type-check onlynpm test           # run the test suite

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.

來源：packages/mcp-server/README.md，提交 301bb96

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分