# @birdycom/omniacss-mcp 中文文档

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

版本：0\.14\.3
npm 元数据更新时间：2026-11-05T08:55:32.932Z
中文译文更新时间：2026-11-08T03:40:55.304Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40birdycom/omniacss-mcp
原文对照：https://npmcn.com/package/%40birdycom/omniacss-mcp/?lang=original
项目主页：https://omniacss.eu/
源码仓库：https://github.com/Birdycom/OmniaCSS

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

- 包体积（解压后）：868 kB，15 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：4 个
- 首次发布：2026-10-29T16:47:13.578Z
- 最新版本发布：2026-11-05T08:55:32.581Z
- 近 30 天下载量：2314（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

OmniaCSS的MCP服务器:让AI助手(Claude, Cursor, Copilot...)检查,向上查找并搜索OmniaCSS的类,变体,彩色符号,OmniaUI组件和块(带有它们的HTML)和docs,并转换Tailwind类.

## 安装

```sh
npm install @birdycom/omniacss-mcp
```

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

## README

# @birtycom/omniacs-mcp (英语)

一个 [MCP 磁共振](https://modelcontextprotocol.io/) 用于服务器 **奥姆尼亚CSS**人工智能助理,如克洛德,Cursor,VS代码副驾驶, Windsurf和Zed用它来检查OmniaCSS的课在他们写之前,而不是从Tailwind猜测.

服务器是只读的: 它永远不会更改您的文件 。 仅 `read_docs` 在网络上, 并且只到 omniachss.eu 和奥姆尼亚伊.eu.

## 工具

| 工具 | 它会做什么 |
| --- | --- |
| `getting_started` | 安装( CDN, npm + PostCSS/ Vite, CLI), 暗模式和写 OmniaCSS 标记的规则 |
| `lookup_classes` | 检查类别,包括变种(`md:hover:…`)和奥姆尼亚UI `oc-*` 课程。 返回准确的 CSS, 或一个打字的最近正确名称 |
| `search_utilities` | 以名称或 CSS 查找类(`"anchor"`, (中文(简体) ), `"grid cols"`, (中文(简体) ), `"position-area"`(中文(简体) ) |
| `list_variants` | 列出每个变体前缀,或显示一个变体产生的选择器或规则 |
| `color_tokens` | 列出主题符号( L)`--oc-primary` 他们的光和暗色, 和调色板颜色(`--color-*`其六进制值 |
| `convert_tailwind` | 为 Tailwind 类提供原生的 OmniaCSS 类, 或迁移插件为其生成的 CSS 类 |
| `list_components` | 查找 OmniaUI 组件( 模式、 标签. ) 和块( 定价、 英雄、 仪表板. ) |
| `get_component` | 一个组件或块的参考 HTML,它所需要的软件包,以及 `npx omniaui add` hTML、React、Vue或Blade 命令 |
| `search_docs` 编号 : `read_docs` | 查找关于 omniacs.eu 和 omniaui.eu 的文档页面和章节,并读取一个文本及其代码示例 |

等级指数是同一个 [OmniaCSS 情报](https://marketplace.visualstudio.com/items?itemName=Birdycom.omniacss-intellisense) 编辑器扩展用法,由同名OmniaCSS版本所建. OmniaUI组件 和屏蔽船与服务器, 用他们的HTML。 当项目安装了自己的OmniaUI软件包时,就会使用这些版本.

欧姆尼亚乌伊 Pro 块和 Pro 组件按名称和描述列出,标签为 Docs 站点显示(`Pro`,或 `Free + Pro` 免费组件,加上Pro。 它们的 HTML 和类仅在项目有 `@birdycom/omniaui-pro` 已安装,带有 [Pro 许可证](https://omniaui.eu/ui/pro)。 。 。 .

## 设置

节点.js 22或更新. 服务器运行于 `npx`,所以没有东西可以先安装.

**克劳德代码**

```bash
claude mcp add omniacss -- npx -y @birdycom/omniacss-mcp
```

**Claude 桌面、 光标、 风浪** (单位:千美元)`claude_desktop_config.json`, (中文(简体) ), `.cursor/mcp.json`, (中文(简体) ), `~/.codeium/windsurf/mcp_config.json`(中文(简体) )

```json
{
  "mcpServers": {
    "omniacss": { "command": "npx", "args": ["-y", "@birdycom/omniacss-mcp"] }
  }
}
```

**VS 代码** (单位:千美元)`.vscode/mcp.json`(中文(简体) )

```json
{
  "servers": {
    "omniacss": { "type": "stdio", "command": "npx", "args": ["-y", "@birdycom/omniacss-mcp"] }
  }
}
```

在您的工程文件夹中启动服务器 。 多数客户端默认这样做;然后安装于 找到项目 .

要将服务器刻入您项目使用的 OmniaCSS 版本, 请在软件包名中插入一个版本, 例如 `@birdycom/omniacss-mcp@0.12`。 。 。 .

一旦连接起来,就问你的助手 _"用OmniaCSS制造了一张定价卡;用OmniaCSS检查各班 运动工具"_。 。 。 .

## 在代码中

```js
import { load } from "@birdycom/omniacss-mcp/knowledge";
const kb = await load();
kb.lookup(["p-1", "md:flx"]);   // [{ token: "p-1", known: true, css: ".p-1 { padding: 1rem; … }" }, { …, hint: 'did you mean "md:flex"?' }]
```

文档 : [https://omniacs.eu/docs/ 互联网档案馆的存檔,存档日期2013-12-22](https://omniacss.eu/docs/) 麻省理工学院

## 常见问题

### @birdycom/omniacss-mcp 是什么？

OmniaCSS的MCP服务器:让AI助手\(Claude, Cursor, Copilot\.\.\.\)检查,向上查找并搜索OmniaCSS的类,变体,彩色符号,OmniaUI组件和块\(带有它们的HTML\)和docs,并转换Tailwind类\.

### 如何安装 @birdycom/omniacss-mcp？

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

### @birdycom/omniacss-mcp 支持 TypeScript 吗？

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

### @birdycom/omniacss-mcp 支持 ESM 还是 CommonJS？

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

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

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

### @birdycom/omniacss-mcp 可以商用吗？

@birdycom/omniacss-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @birdycom/omniacss-mcp 的下载量有多少？

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

### @birdycom/omniacss-mcp 还在维护吗？

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