Color Theory MCP

色彩理论MCP服务器

](https://www.npmjs.com/package/color-theory-mcp) ](https://www.npmjs.com/package/color-theory-mcp)  ](https://nodejs.org)  

一个全面的MCP（模型上下文协议）服务器，提供24种颜色理论操作工具，包括颜色空间转换、和谐生成、可访问性验证和文化意义查找。

目录

• 特性
• 安装
• 快速开始
• 用法
• 工具
• 示例
• 建筑
• 贡献
• 参考文献
• 获取帮助
• 许可证

特性

• 15个颜色空间：sRGB、线性sRGB、显示器P3、XYZ-D65、XYZ-D50、Lab、LCH、Oklab、Oklch、HSL、HSV、HWB、CMYK、， CAM16, 造血干细胞
• 12种混合模式：乘法、网屏、叠加、柔光、烧色、减法（颜料）等。
• 高级可访问性: APCA（Lc）, 道尔顿化 （CVD校正），WCAG 2.2非文本
• 产品出口：设计令牌 iOS Swift, 安卓XML, 南海, Figma JSON，顺风
• 7和谐算法：互补、类比、三向、分裂互补、四向、方形、单色
• 色觉缺陷：前斜视、后斜视、三斜视的模拟与校正
• ΔE计算：CIE76、CIE94、CIEDE2000感知差异公式
• 147 CSS命名颜色：查找和最接近的匹配查找
• 文化意义：跨越西方、东亚、南亚和中东文化的颜色关联

安装

npm install color-theory-mcp

或者从源代码安装：

git clone https://github.com/JoshuaRamirez/color-theory-mcp.git
cd color-theory-mcp
npm install
npm run build

快速开始

在一分钟内起床并跑步：

1. 安装软件包：

   npm install color-theory-mcp

1. 添加到您的Claude Code MCP设置中 （参见 用法 详细信息）：

   {
     "mcpServers": {
       "color-theory": {
         "command": "node",
         "args": ["node_modules/color-theory-mcp/dist/index.js"]
       }
     }
   }

1. 开始使用颜色工具：

   "Convert #FF5733 to Oklch" -> Use convert-color
   "Is this text accessible?" -> Use validate-wcag-contrast
   "Generate a triadic palette from blue" -> Use generate-harmony

用法

使用克劳德代码

添加到您的Claude Code MCP设置中：

{
  "mcpServers": {
    "color-theory": {
      "command": "node",
      "args": ["/path/to/color-theory-mcp/dist/index.js"]
    }
  }
}

发展

npm run dev      # Run with tsx (development)
npm run build    # Build TypeScript
npm run test     # Run tests

工具

查询工具（4）

• get-color-info -全面的颜色信息
• get-color-name -查找最接近的CSS命名颜色
• get-color-meaning -文化/心理意义
• list-named-colors -列出CSS命名颜色

转换工具（3）

• convert-color -转换为任何颜色空间（支持15+）
• convert-batch -转换多种颜色
• parse-color-string -解析CSS颜色4格式（oklch、lab、hwb等）

计算工具（5）

• calculate-contrast -WCAG/APCA对比度
• calculate-delta-e -感知差异（CIE76/94/2000）
• calculate-luminance -相对亮度
• mix-colors -混合/混合颜色（混合模式，减法）
• adjust-color -调亮/调暗/饱和/旋转色调

生成工具（6）

• generate-harmony -色轮和谐
• generate-palette -设计系统调色板（HCT/材料）
• generate-gradient -带缓震功能的多站渐变
• generate-accessible-palette -符合WCAG/APCA标准的替代品
• generate-design-tokens -IOS、Android、SCSS、figma JSON
• generate-scale -顺风风格50-950比例尺

验证工具（5）

• validate-wcag-contrast -WCAG 2.2和APCA检查
• validate-color-blindness -CVD模拟和道尔顿化
• validate-gamut -色域内验证和感知映射
• validate-print-safe -CMYK可行性
• validate-palette-harmony -和谐分析

示例

检查可访问性

"Is #333333 on #FFFFFF WCAG AA compliant?"
→ Use validate-wcag-contrast

生成调色板

"Generate a 5-color analogous harmony from navy blue"
→ Use generate-harmony with harmonyType: "analogous"

模拟色盲

"How does this palette look to someone with deuteranopia?"
→ Use validate-color-blindness with cvdType: "deuteranopia"

转换颜色空间

"Convert #FF5733 to Oklch"
→ Use convert-color with targetSpace: "oklch"

建筑

src/
├── domain/           # Value objects & interfaces
│   ├── values/       # Color, Palette, Gradient, Matrix3x3
│   └── interfaces/   # IColorSpace, IHarmonyAlgorithm, etc.
├── color-spaces/     # Color space implementations
├── services/         # ConversionService, ContrastService, PaletteService
├── strategies/       # Delta-E, CVD, Harmony algorithms
├── data/             # CSS colors, cultural meanings
└── mcp/tools/        # MCP tool implementations

贡献

我们欢迎捐款！请查看我们的 贡献指南 有关以下内容的详细信息：

• 行为准则
• 开发设置
• 提交拉取请求
• 编码标准

有关更改的历史记录，请参阅 更新日志.

参考文献

• W3C CSS颜色4
• Björn Ottosson的Oklab
• CIEDE2000（夏尔马，2005）
• WCAG 2.1对比度
• Machado 2009 CVD模拟

获取帮助

• 错误报告: 打开一个问题
• 功能请求: 打开一个问题
• 安全问题：请查看我们的 安全策略 负责披露
• 讨论:

许可证

麻省理工学院-见 许可证 了解详情。