pudge-ui

本地服务

ui.pudgestudio.com开发工具1115 周前更新

代码仓库访问官网

关于 pudge-ui

pudge-ui 的 MCP 服务为编码 Agent 提供可查询的设计系统组件规格，适用于依据组件规范编写界面的开发流程。规格随包提供，查询工具为只读。

主要功能

01按类别列出组件
02按名称、描述或标签搜索
03获取基础规范文档
04查询单个或多个组件规格
05获取组合及引用组件规格

适用场景

01编码 Agent 查询组件实现细节
02按类别筛选设计系统组件
03获取组合及相关组件规范

MCP 相关

该 MCP 服务向 MCP 客户端提供组件目录、基础规范、组件规格和组合规格查询工具。工具为只读，规格随软件包提供。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y @pudge-ui/mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@pudge-ui/mcp-server0.2.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
category	string	否	可选的 category id，用于筛选类别，例如 'buttons'、'toggles'、'dials'、'sliders'、'readouts'、'meters'、'navigation'、'forms'、'overlays'、'indicators'、'data'。省略则列出全部 93 个组件。

详细介绍

@pudge-ui/mcp-server

用于 pudge-ui 设计系统的 MCP 服务。支持编码 Agent 以编程方式查询组件规范。

安装

添加到 MCP 客户端配置中（例如 Claude Desktop、Claude Code）：

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

本地开发：

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

可用工具

工具	描述
`list_components`	列出所有组件，可按类别筛选
`search_components`	按名称、描述或标签模糊搜索组件
`get_foundation`	获取基础规范文档（核心 5 项或扩展 9 项）
`get_component`	获取单个组件的完整规范（基础 + 规范）
`get_components`	获取多个组件的规范（基础仅包含一次）
`get_composition`	获取组合规范及所有引用组件的规范

示例

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 })

所有工具均为只读（带有 readOnlyHint 注解）——此服务不会写入你的文件系统，也不会发起网络请求。规范已打包在程序包中。

开发

npm install
npm run dev        # run with tsx
npm run build      # compile + copy spec
npm run typecheck  # type-check only
npm test           # run the test suite