# @besaitech/ng-design-system-mcp 中文文档

规范地址：https://npmcn.com/package/%40besaitech/ng-design-system-mcp/

版本：0\.0\.31
npm 元数据更新时间：2026-11-05T12:04:50.962Z
中文译文更新时间：2026-11-07T23:45:45.415Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40besaitech/ng-design-system-mcp
原文对照：https://npmcn.com/package/%40besaitech/ng-design-system-mcp/?lang=original

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

- 包体积（解压后）：812 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-08-31T22:19:33.164Z
- 最新版本发布：2026-11-05T12:04:50.744Z
- 近 30 天下载量：1985（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

MCP服务器,可以将@besaitech/ng-design-system Angular组件库文档(API,例,符,图标,设置)向AI编码工具曝光.

## 安装

```sh
npm install @besaitech/ng-design-system-mcp
```

也可以使用：`pnpm add @besaitech/ng-design-system-mcp`、`yarn add @besaitech/ng-design-system-mcp`、`bun add @besaitech/ng-design-system-mcp`

## README

# @besaitech/ng-design-system-mcp (英语)

一个 [MCP 磁共振](https://modelcontextprotocol.io/) 显示 **`@besaitech/ng-design-system`** 角组件库文档到AI编码工具(Claude Code, Cursor, Windsurf...).

它让助理查看真正的选择器、输入、enum值、输出(包括 双向 `model()` 更改活动),导出类型,内容-投影槽,设计符号, 注册图标名称、可复制示例和 Tailwind-v4 设置——然后 **验证** 页:1 它生成代码——因此它不再猜测API.

文档是 **构建时从库源生成** 并捆入这个 软件包为 `data/docs.json`,该版本被贴在它描述的图书库版上. 从来没有 飘来飘去,从不给网络打电话.

## 安装

向公众公布npm登记簿,与其所记录的图书馆相同:

```bash
npm install -g @besaitech/ng-design-system-mcp
```

没有瞄准镜映射, 没有 `.npmrc` 不需要任何纪念品.

## 注册服务器

### 克劳德代码

```sh
claude mcp add saitech-design-system -- npx -y @besaitech/ng-design-system-mcp
```

### `.mcp.json` (承诺的消费回购)

```json
{
  "mcpServers": {
    "saitech-design-system": {
      "command": "npx",
      "args": ["-y", "@besaitech/ng-design-system-mcp@0.0.5"]
    }
  }
}
```

> **按下您安装的同一版本 `@besaitech/ng-design-system`** 因此,文档匹配 密码你飞了。 这个 `sds://meta` 资源及 `sds_get_setup` 呼应捆绑 `libraryVersion` 因此,代理可以确认 它的编码对什么.

### 光标/ 微风突起

在工具的 MCP 配置中使用相同的 stdio 命令(`command: npx`, (中文(简体) ), `args: ["-y", "@besaitech/ng-design-system-mcp"]`) (中文(简体) ).

## 它提供的东西

**工具**

| 工具 | 目的 |
| --- | --- |
| `sds_list_components` | 发现目录( filter by `kind` 编号 : `group`(中文(简体) ) |
| `sds_get_component` | 一个组件的完整 API( 模糊: 类名、 选择器或空名) |
| `sds_get_examples` | 按款次分类的可复制文件 |
| `sds_search` | 在名称、说明、输入、类型、实例之间搜索关键字 |
| `sds_validate_usage` | 插入生成的标记( 选择器、 输入器、 enums、 需要、 图标、 CVA) `[value]`(中文(简体) ) |
| `sds_validate_icon` | 检查一个 `<sds-icon name>` (+建议) |
| `sds_get_token` | 带有 Tailwind 工具+ CSS 变量的设计符号 |
| `sds_get_setup` | 安装 + Tailwind- v4 核对表( # 1 “ 放弃未设置的” 固定) |

**资源** —— 说 `sds://docs.json`, (中文(简体) ), `sds://meta`, (中文(简体) ), `sds://component/{selectorOrClass}`, (中文(简体) ), `sds://components/{selector}.md`, (中文(简体) ), `sds://llms.txt`。 。 。 .

**提示** —— 说 `sds_generate_component_usage`, (中文(简体) ), `sds_scaffold_form`, (中文(简体) ), `sds_build_data_table`。 。 。 .

## 贡献者模式( 单列内置)

从活的工作树上为文件服务(启动时从源重取,不重建):

```sh
node packages/mcp-server/dist/index.js --source /path/to/saitech-design-system
```

`--data <path>` 服务于特定 `docs.json`。 。 。 . `--http` 用于未来共享 实例(目前回到 stdio).

## 如何构建并发布( E)

从工作空间根 :

```sh
npm run docs:index     # regenerate data/docs.json (+ docs/ by-products) from source
npm run build:mcp      # docs:index, then tsc -> dist/
npm run release:mcp    # bump, build, publish to npm
npm run release:all    # release the library, then this server (lockstep)
```

`prebuild:lib` 在每个索引之前重新生成索引 `ng build saitech-design-system`和CI 数据 (单位:千美元)`npm run check:docs`如果承诺的指数偏离源头则失败.

## 常见问题

### @besaitech/ng-design-system-mcp 是什么？

MCP服务器,可以将@besaitech/ng-design-system Angular组件库文档\(API,例,符,图标,设置\)向AI编码工具曝光\.

### 如何安装 @besaitech/ng-design-system-mcp？

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

### @besaitech/ng-design-system-mcp 支持 TypeScript 吗？

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

### @besaitech/ng-design-system-mcp 支持 ESM 还是 CommonJS？

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

### @besaitech/ng-design-system-mcp 需要什么版本的 Node\.js？

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

### @besaitech/ng-design-system-mcp 可以商用吗？

@besaitech/ng-design-system-mcp 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @besaitech/ng-design-system-mcp 的下载量有多少？

根据 npm 官方下载统计，@besaitech/ng-design-system-mcp 在 2026/10/08 – 2026/11/06 这 30 天内被下载 1,985 次，日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @besaitech/ng-design-system-mcp 还在维护吗？

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