# @ama-styling/mcp 中文文档

规范地址：https://npmcn.com/package/%40ama-styling/mcp/

版本：15\.3\.1
npm 元数据更新时间：2026-11-10T11:04:17.722Z
中文译文更新时间：2026-11-10T12:21:55.594Z
软件包许可：BSD-3-Clause

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

原始 npm 页面：https://www.npmjs.com/package/%40ama-styling/mcp
原文对照：https://npmcn.com/package/%40ama-styling/mcp/?lang=original
项目主页：https://amadeusitgroup.github.io/otter/
源码仓库：https://github.com/AmadeusITGroup/otter

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

- 包体积（解压后）：55.8 kB，27 个文件
- TypeScript 类型：未声明
- Node.js 要求：^22\.22\.3 \|\| ^24\.15\.0 \|\| ^26\.0\.0
- 运行依赖：6 个
- 首次发布：2026-09-01T13:52:34.892Z
- 最新版本发布：2026-11-10T11:04:17.286Z
- 近 30 天下载量：2924（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：65（近 12 个月 65 个）

## 中文简介

实验包 -- -- MCP模块,向AI助手披露设计符号信息

## 安装

```sh
npm install @ama-styling/mcp
```

也可以使用：`pnpm add @ama-styling/mcp`、`yarn add @ama-styling/mcp`、`bun add @ama-styling/mcp`

## README

# 阿玛·斯丁林 MCP

![Super cute Otter!](https://raw.githubusercontent.com/AmadeusITGroup/otter/main/assets/logo/otter.png)

  
  

> \[尖叫声\] [实验](https://github.com/AmadeusITGroup/otter/blob/main/README.md#experimental)

## 说明

一个MCP(Model Context Protocol)服务器,向AI助理披露设计符元数据,以进行符号发现并推荐. 上面写着: `styling.metadata.json` 文件并提供了用于列出、过滤和寻找CSS中最佳设计符号的工具.

## 工具

| 工具 | 说明 |
| --- | --- |
| `list_design_tokens` | 列出可用的设计符号及其描述,值,类型,类别和标记. 支持按类别,标签,类型,或名称模式(regex)进行可选过滤. |
| `find_design_token` | 鉴于CSS属性和语义上下文,建议使用最好的匹配设计符来代替硬编码值. |

## 如何使用 VSCode

要添加 Design Tokens MCP 服务器, 您应该首先使用 `"chat.mcp.enabled": true`。 。 。 .

然后,在你身边 `.vscode/mcp.json` 添加:

```json5
{
  "AmaStyling": {
    "type": "stdio",
    "command": "npx",
    "args": [
      "-y", "-p", "@ama-styling/mcp", "ama-styling-mcp-start",
      "--metadata", "./path/to/styling.metadata.json"
    ],
    "env": {
      // Help us improve Otter by setting this to true.
      // More details on our privacy policy: https://github.com/AmadeusITGroup/otter/blob/main/PRIVACY.md
      "O3R_METRICS": true
    }
  }
}
```

## CLI 选项

| 选项 | 说明 | 默认 |
| --- | --- | --- |
| `-m, --metadata <path>` | 路径 `styling.metadata.json` 文件 | `./styling.metadata.json` |
| `--cache-path <path>` | 缓存文件路径 | `.cache/@ama-styling/mcp` |
| `--log-level <level>` | 日志级别 : `debug`, (中文(简体) ), `info`, (中文(简体) ), `warn`, (中文(简体) ), `error` | `info` |

## 元数据文件格式

服务器期望有一个JSON文件,其结构如下:

```json
{
  "variables": {
    "--color-primary": {
      "name": "--color-primary",
      "defaultValue": "#3b82f6",
      "type": "color",
      "category": "brand",
      "tags": ["primary", "interactive"],
      "description": "Primary brand color for interactive elements",
      "label": "Primary Color"
    }
  }
}
```

每个可变条目支持:

| 外地 | 类型 | 说明 |
| --- | --- | --- |
| `name` | `string` | CSS 自定义属性名( 需要) |
| `defaultValue` | `string` | 变量的默认值( 需要) |
| `type` | `"color" | "string"` | 数值类型 |
| `category` | `string` | 键类 |
| `tags` | `string[]` | 分类标签 |
| `description` | `string` | 人可读描述 |
| `label` | `string` | 显示标签 |
| `references` | `CssVariable[]` | 其他符号此可变引用 |
| `component` | `{ library, name }` | 构成部分关联 |

> \[注\] 此元数据文件通常是由 `@ama-styling/style-dictionary` 包件作为设计符号构建管道的一部分.

## 常见问题

### @ama-styling/mcp 是什么？

实验包 -- -- MCP模块,向AI助手披露设计符号信息

### 如何安装 @ama-styling/mcp？

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

### @ama-styling/mcp 支持 TypeScript 吗？

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

### @ama-styling/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^22\.22\.3 \|\| ^24\.15\.0 \|\| ^26\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ama-styling/mcp 可以商用吗？

@ama-styling/mcp 使用 BSD-3-Clause 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括，不构成法律意见，请以许可原文为准。

### @ama-styling/mcp 的下载量有多少？

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

### @ama-styling/mcp 还在维护吗？

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