# @cooperco/component-library-mcp-server 中文文档

规范地址：https://npmcn.com/package/%40cooperco/component-library-mcp-server/

版本：0\.1\.154
npm 元数据更新时间：2026-11-05T18:14:45.554Z
中文译文更新时间：2026-11-11T10:30:24.481Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40cooperco/component-library-mcp-server
原文对照：https://npmcn.com/package/%40cooperco/component-library-mcp-server/?lang=original
项目主页：https://github.com/Cryobank/Cordblood-Component-Library#readme
源码仓库：https://github.com/Cryobank/Cordblood-Component-Library

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

- 包体积（解压后）：64.6 kB，34 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-03-13T20:19:18.134Z
- 最新版本发布：2026-11-05T18:14:45.287Z
- 近 30 天下载量：2214（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：71（近 12 个月 71 个）

## 中文简介

库珀组件库的MCP服务器. 提供组件文档,道具检查,彩色调色板信息,以及AI助手的脚手架工具.

## 安装

```sh
npm install @cooperco/component-library-mcp-server
```

也可以使用：`pnpm add @cooperco/component-library-mcp-server`、`yarn add @cooperco/component-library-mcp-server`、`bun add @cooperco/component-library-mcp-server`

## README

# @ cooperco/ 组件- 图书馆- mcp- 服务器

库珀组件库的MCP(模式上下文协议)服务器. 给予克劳德代码等AI助手访问组件文档,道具类型,彩色调色板,通过配置,和脚手架工具.

## 安装

```bash
npm install -g @cooperco/component-library-mcp-server
# or use npx (no install needed)
```

## 配置 Claude 代码

添加到您的项目 `.claude/settings.json`数字 :

```json
{
  "mcpServers": {
    "cooper-components": {
      "command": "npx",
      "args": ["-y", "@cooperco/component-library-mcp-server"]
    }
  }
}
```

服务器通过从工作目录上走来搜索工程根 `src/components/components.ts`。 。 。 .

### 明确项目路径

如果自动检测不起作用(例如,你处于单列状态),明确通过路径:

```json
{
  "mcpServers": {
    "cooper-components": {
      "command": "npx",
      "args": ["-y", "@cooperco/component-library-mcp-server", "/path/to/Cordblood-Component-Library"]
    }
  }
}
```

或者使用环境变量 :

```json
{
  "mcpServers": {
    "cooper-components": {
      "command": "npx",
      "args": ["-y", "@cooperco/component-library-mcp-server"],
      "env": {
        "COOPER_PROJECT_ROOT": "/path/to/Cordblood-Component-Library"
      }
    }
  }
}
```

### 地方发展(在此范围内)

在组件库本身工作时,使用本地建筑 :

```json
{
  "mcpServers": {
    "cooper-components": {
      "command": "node",
      "args": ["mcp/dist/index.js"]
    }
  }
}
```

## 工具

| 工具 | 说明 |
| --- | --- |
| `list-components` | 列出包含类别、变体和描述的所有组件 |
| `get-component` | 一个组件的完整文件:道具、事件、插槽、通过和源代码 |
| `get-component-props` | 有类型、默认和所需状态的焦点道具表 |
| `get-color-palettes` | 彩色调色板系统:可用的调色板、结构和使用 |
| `get-passthrough-config` | 通过密钥和组件默认的 Tailwind 类 |
| `search-components` | 按名称、类别或道具名称搜索组件 |
| `scaffold-component` | 生成带有.vue、.ts和.stories.ts文件的新组件 |

## 实例

一旦配置,克洛德代码可以自动使用工具:

-   _"有什么组件可用?"_ 电话 `list-components`
-   _"给我看看集装箱模型的道具"_ 电话 `get-component`
-   _"我可以用什么调色板?"_ 电话 `get-color-palettes`
-   _创造出新的BannerModule组件_ 电话 `scaffold-component`

## 如何运作

服务器在运行时读取您的组件库源文件 :

-   解析类型脚本接口 `ComponentName.ts` 使用 TypeScript 编译器 API 文件
-   摘录 `withDefaults`, (中文(简体) ), `defineEmits`,以及 `<slot>` 来自 `.vue` 文件
-   读取通过配置 `src/config/defaultPassthrough/index.ts`
-   读取调色板 `src/config/colorPalettes.ts`
-   发现组件来自 `src/components/components.ts` 桶出口

结果被缓存在内存中,当源文件改变时无效,因此文档总是流出.

## 常见问题

### @cooperco/component-library-mcp-server 是什么？

库珀组件库的MCP服务器\. 提供组件文档,道具检查,彩色调色板信息,以及AI助手的脚手架工具\.

### 如何安装 @cooperco/component-library-mcp-server？

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

### @cooperco/component-library-mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @cooperco/component-library-mcp-server 支持 ESM 还是 CommonJS？

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

### @cooperco/component-library-mcp-server 可以商用吗？

@cooperco/component-library-mcp-server 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @cooperco/component-library-mcp-server 的下载量有多少？

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

### @cooperco/component-library-mcp-server 还在维护吗？

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