AI导哈

颜色理论工具服务器

一个提供24种颜色理论操作工具的MCP服务器，包括颜色空间转换、和谐生成、无障碍验证和文化含义查询等功能。

  • by JoshuaRamirez
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 JoshuaRamirez/color-theory-mcp

使用说明

色彩理论MCP服务器

一个全面的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

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

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

  3. 开始使用颜色工具：

    "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

贡献

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

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

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

参考文献

获取帮助

许可证

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

相关 MCP