@ama-styling/mcp

中文文档
15.3.1发布于 2026/11/10BSD-3-Clause构建来源已验证近 30 天下载 2924

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

中文使用文档
文档目录5 节
  1. 说明
  2. 工具
  3. 如何使用 VSCode
  4. CLI 选项
  5. 元数据文件格式

阿玛·斯丁林 MCP

Super cute Otter!



[尖叫声] 实验

说明

一个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 添加:

{
  "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, (中文(简体) ), errorinfo

元数据文件格式

服务器期望有一个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"
    }
  }
}

每个可变条目支持:

外地类型说明
namestringCSS 自定义属性名( 需要)
defaultValuestring变量的默认值( 需要)
type"color" | "string"数值类型
categorystring键类
tagsstring[]分类标签
descriptionstring人可读描述
labelstring显示标签
referencesCssVariable[]其他符号此可变引用
component{ library, name }构成部分关联

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

版本与发布记录

@ama-styling/mcp 共发布 65 个版本,首次发布于 2026/09/01;过去 12 个月发布了 65 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
15.3.1latest2026/11/10今天
15.4.0-prerelease.9prerelease2026/11/091 天前
15.4.0-prerelease.82026/11/073 天前
15.4.0-prerelease.72026/11/073 天前
15.3.0-rc.2rc2026/11/064 天前
15.4.0-prerelease.62026/11/064 天前

其他发布通道:v15-updated → 15.1.3,rc → 15.3.0-rc.2,prerelease → 15.4.0-prerelease.9。

关于 @ama-styling/mcp 的常见问题

@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 和提交记录判断。