# design-lounge-mcp 中文文档

规范地址：https://npmcn.com/package/design-lounge-mcp/

版本：0\.2\.6
npm 元数据更新时间：2026-11-03T10:58:06.780Z
中文译文更新时间：2026-11-03T11:46:36.475Z
软件包许可：SEE LICENSE IN skill/LICENSE

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/design-lounge-mcp
原文对照：https://npmcn.com/package/design-lounge-mcp/?lang=original
项目主页：https://www.designlounge.live/
源码仓库：https://github.com/SusanAcharya/Design-Lounge

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：28 MB，2225 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：4 个
- 首次发布：2026-10-26T19:55:17.759Z
- 最新版本发布：2026-11-03T10:58:06.558Z
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

作为MCP服务器的设计休息室：库，方向选择，以及捕获AI赠品和SEO， AEO和GEO差距的审查。

## 安装

```sh
npm install design-lounge-mcp
```

也可以使用：`pnpm add design-lounge-mcp`、`yarn add design-lounge-mcp`、`bun add design-lounge-mcp`

## README

# Design Lounge MCP

将Lounge设计为MCP服务器。您的代理可以：

-   **来自图书馆的设计**： 600+件简报，80+主题，40+类型配对，40+食谱与方向，休息室图标，和田三三的颜色组合。它每次都选择相同的方向，使两个站点看起来不一样。
-   **移除AI赠品**：股票副本，em破折号，图标卡三人组，渐变，靛蓝调色板，表情符号图标，合成数字，以及锁定主题，配对和家庭的漂移。
-   **被发现并被引用**： SEO， AEO（答案引擎）和GEO （ChatGPT, Claude, Perplexity, Gemini）。它检查头部、共享卡、搜索和AI爬虫的robots.txt、服务器呈现的文本和JSON-LD。
-   **看这一页**：铬在1280×800和390×844与减少运动。它运行斧头，测量面，标签，主要和点击目标，并保存截图。

服务器读取相同的内容 `skills/design-lounge` 文件夹作为技能，所以规则活在一个地方。技巧就是方法。服务器完成了散文无法完成的部分：搜索、针对历史的确定性选择、每个片段的图片、主题和配对，以及检查读取和呈现页面。

## 技能是随之而来的

安装服务器即安装技能。当服务器启动时，它会输入技能 `~/.agents/skills/design-lounge` 并将其链接到机器上每个客户的技能文件夹中：Claude Code (`~/.claude/skills`)、游标(`~/.cursor/skills`)和法典(`~/.codex/skills`）. 这是相同的布局 `skills` CLI使用。加载技能的客户在设计之前就有了完整的方法。第一次启动后重新加载客户端一次。

-   当服务器更新时，它更新自己的副本。
-   它只保留了其他安装的东西的副本，例如 `npx skills add` 或者是手工编辑，并且这么说。 `install_skill` 与 `replace: true` 将其交换为服务器的副本。
-   `install_skill` 与 `project_path` 还将其复制到项目的 `.claude/skills`， `.cursor/skills`, `.agents/skills`，适用于只阅读项目技能的客户。
-   在一个没有技能支持的客户中， `start_design` 返回必须保持的规则（它们的单词获胜，rules列表，而Look失败），从相同的文件中读取，以及 `read_guide` 为其他人服务。
-   `DESIGN_LOUNGE_SKILL_INSTALL=off` 关闭安装。

## 将其添加到您的代理中

**克劳德代码**

```sh
claude mcp add design-lounge --scope user -- npx -y design-lounge-mcp@latest
```

**光标** （`~/.cursor/mcp.json`)， **风帆冲浪**， **克劳德桌面** （`claude_desktop_config.json`)，以及其他采用这种形状的客户端：

```json
{
  "mcpServers": {
    "design-lounge": { "command": "npx", "args": ["-y", "design-lounge-mcp@latest"] }
  }
}
```

**VS代码** （`.vscode/mcp.json`):

```json
{ "servers": { "design-lounge": { "type": "stdio", "command": "npx", "args": ["-y", "design-lounge-mcp@latest"] } } }
```

**食典委** （`~/.codex/config.toml`):

```toml
[mcp_servers.design-lounge]
command = "npx"
args = ["-y", "design-lounge-mcp@latest"]
```

`@latest` 使每个开始检查一个新的版本，所以库更新到达您不需要重新安装。在第一次启动后重新加载客户机一次，以便它获取服务器安装的技能。

渲染检查（截图，斧头，测量标签和按钮，主题板和类型样本）需要无头铬。让你的代理人逃跑 `install_browser` 一次（约100 MB），或运行 `npx playwright install chromium --only-shell`． 没有它，每隔一次检查仍在运行，报告说它没有看。

**主持**对克劳德来说。ai、ChatGPT和其他无法运行本地程序的客户端：add `https://www.designlounge.live/api/mcp` 作为自定义连接器（可流式传输HTTP，无需登录）。它有图书馆， `start_design`，选择，以及公共url或粘贴的HTML的静态审查。它省略了需要您的机器的内容：文件路径、历史文件、技能和浏览器安装以及呈现的检查。它只获取公共地址，每个地址每分钟允许60次请求。把你最近的选择作为 `history` 如果你保留它们。

要从repo的克隆版本运行它： `cd mcp && pnpm install`，然后使用 `node /path/to/designs/mcp/src/server.mjs` 作为命令。

## 工具

| 工具 | 它是做什么的 |
| --- | --- |
| `start_design` | 第一次打电话。读取他们的文字（流程、模式、命名风格、平静文字），对食谱进行排序，读取项目文件夹和最近的选择，并返回摘要和步骤 |
| `get_recipe` | 一份食谱的说明，每一个都标明了历史阻碍它的时间 |
| `pick_direction` | 平静字过滤，历史记录，组检查，然后名字号码。你传递合适的指示 |
| `check_pick` | 对英雄、工作、页脚、形状和框架进行唯一性检查。返回不像行 |
| `record_pick` | 将已声明或已完成的行追加到 `~/.design-lounge/history.jsonl` 并报道了早先的声明 |
| `search_pieces` / `get_piece` | 找一篇文章，读一下摘要。 `get_piece` 附加演示的缩略图，和 `demo: true` 添加它的HTML源代码。 `search_pieces` 与 `images: true` 附加前六个缩略图 |
| `browse_library` | 主题和配对的心情，加上家庭，食谱，类别，收藏，种类，运动，和规模 |
| `get_theme` / `get_pairing` / `get_family` | 锁定的令牌和规则，如CSS。一个主题有一个角色板，并与一个模式标本配对 |
| `get_icons` / `search_wada` | 休息室图标作为SVG。和田的组合按单词或最近的十六进制 |
| `read_guide` | 任何方法文件，或其中的一个部分 |
| `review_page` | 一切同时进行：设计、可访问性、SEO、AEO、GEO。失败首先出现，每一个都有它的证据和解决办法。网页和手机帧返回为图像 |
| `match_reference` | 他们展示一个网站或截图，想要那种感觉。测量其颜色角色、类型、角、阴影、密度、英雄形状、部分和运动，并命名最接近的主题、配对、家庭和部分。它符合感觉；它从不复制网站 |
| `install_skill` | 在项目中安装技能，或替换以其他方式安装的用户副本 |
| `install_browser` | 下载渲染检查使用的无头Chromium，一次 |
| `audit_slop` | 仅限设计：AI赠品和套件漂移 |
| `audit_search` | 只有SEO， AEO和GEO |
| `suggest_schema` | JSON-LD仅根据页面上的事实构建，并列出了缺失的字段 |

每个审查工具都需要 `path` （文件或文件夹） `index.html`)， `url` （live或localhost），或 `html`． 对于一个 `path`，上面写着 `DESIGN.md` 在页面的旁边或上面学习锁定主题，配对，家庭，自由模式和命名美学。A Named aesthetic取消了它列出的禁令。

服务器还提供了三个提示， `design`， `review`, `deslop`，并将方法文件作为资源放在 `lounge://guide/<file>`。

## 它写什么，什么离开你的机器

-   **的技能。** 开始时，它将技能写入 `~/.agents/skills/design-lounge` 并链接到 `~/.claude/skills`， `~/.cursor/skills`, `~/.codex/skills` 为了你的客户。不是它制造的复制品永远不会被替换。 `DESIGN_LOUNGE_SKILL_INSTALL=off` 关掉这个。要删除它，请删除这些文件夹。
-   **最近的选择。** `record_pick` 追加一行到 `~/.design-lounge/history.jsonl`，所以你创建的两个站点不会出现相同的结果。没有别的东西可以读取它。
-   **缓存的图片。** 主题板和类型样本缓存在 `~/.cache/design-lounge/boards`． 截图到你的临时文件夹，或者到 `out_dir`。
-   **托管端点** 一直没有。每个请求都获得一个新的服务器，它审查的页面被获取和删除。
-   **网络。** 审查从您的机器中获取您的页面名称、它的样式表、robots.txt、sitemap.xml、llms.txt和共享图像。谷歌字体加载类型样本。缩略图和演示是捆绑的；designlounge。活着只要求得到一件失去的东西。任何东西都不会发送到Design Lounge，也没有跟踪。

## 设置

| 变量 | 默认的 |
| --- | --- |
| `DESIGN_LOUNGE_SKILL` | 的捆绑 `skill/`,然后 `../skills/design-lounge` |
| `DESIGN_LOUNGE_HISTORY` | `~/.design-lounge/history.jsonl` |
| `DESIGN_LOUNGE_SKILL_INSTALL` | 上。集 `off` 跳过安装技能 |
| `DESIGN_LOUNGE_ASSETS` | 的捆绑 `assets/`，然后是回购 `public/thumbs` 和 `src/demos`，然后是现场直播 |
| `DESIGN_LOUNGE_CACHE` | `~/.cache/design-lounge/boards`，用于制作主题板和标本 |

## 开发

```sh
pnpm test                              # unit tests and a stdio round trip
pnpm release patch --dry-run           # sync the skill, test, and pack, without publishing
node test/client.mjs                   # list the tools
node test/client.mjs review_page '{"path":"test/fixtures/slop.html"}'
```

`pnpm release patch` (或minor， major, x.y.z, with `--otp <code>` 对于npm 2FA)从库中同步技能，运行测试，碰撞包。Json和服务器。将其发布到npm和MCP Registry，然后提交和标记。它从不推动。

`pnpm pack` 首先将技能文件夹复制到 `skill/`，以及缩略图和演示 `assets/` （`scripts/bundle.mjs`)，因此发布的包包含库和图片。大约12 MB打包。

设计使用 [设计休息室](https://www.designlounge.live/) 苏珊·阿查里亚著。

## 常见问题

### design-lounge-mcp 是什么？

作为MCP服务器的设计休息室：库，方向选择，以及捕获AI赠品和SEO， AEO和GEO差距的审查。

### 如何安装 design-lounge-mcp？

在项目目录运行 npm install design-lounge-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 design-lounge-mcp，可以用 npx design-lounge-mcp 直接运行。

### design-lounge-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/design-lounge-mcp 是否存在。

### design-lounge-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### design-lounge-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### design-lounge-mcp 可以商用吗？

design-lounge-mcp 使用 SEE LICENSE IN skill/LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### design-lounge-mcp 还在维护吗？

最新版本 0\.2\.6 发布于 2026/11/03（今天）；至今共发布 8 个版本，其中过去 12 个月发布了 8 个；首次发布于 2026/10/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。