Color Scheme Generator

配色方案生成器 MCP 服务

这是一个使用 The Color API 生成和谐配色方案的 Model Context Protocol（MCP）服务。它提供多种配色方案生成工具，可为设计项目创建美观且协调的调色板。

功能

该服务提供 8 种不同的配色方案生成工具：

1. 单色方案：同一色相的不同变化

   • 标准单色
   • 深色单色
   • 浅色单色

2. 基于色轮的方案：

   • 类似色：色轮上相邻的颜色，适合和谐的设计
   • 互补色：相对的颜色，具有高对比度
   • 类似互补色：结合类似色和互补色
   • 三色：间隔均匀的三种颜色，形成均衡的调色板
   • 四色：间隔均匀的四种颜色，形成多样的调色板

前置条件

• Node.js（v18 或更高版本）
• npm、yarn 或 pnpm
• MCP 客户端（例如 Claude Desktop、Cursor）

安装

1. 克隆并安装依赖项：

   git clone <repository-url>
   cd colors-mcp-server
   npm install
   

2. 构建服务：

   npm run build
   

3. 配置 MCP 客户端：

   对于 Claude Desktop（claude_desktop_config.json）：

   {
     "mcpServers": {
       "color-scheme-generator": {
         "command": "node",
         "args": ["/full/path/to/colors-mcp-server/build/index.js"]
       }
     }
   }
   

   对于 Cursor：

   • 前往 Settings > MCP > Add new global MCP server
   • 使用与上方相同的配置

用法

颜色输入格式

该服务接受多种格式的颜色：

• Hex："098765" 或 "#098765"
• RGB："0,71,171" 或 "rgb(0,71,171)"
• HSL："215,100%,34%" 或 "hsl(215,100%,34%)"

参数

• color：种子颜色（必填）
• count：要生成的颜色数量（可选，默认值：5，范围：3-10）

可用工具

• generate_monochrome_scheme
• generate_monochrome_dark_scheme
• generate_monochrome_light_scheme
• generate_analogic_scheme
• generate_complement_scheme
• generate_analogic_complement_scheme
• generate_triad_scheme
• generate_quad_scheme

用法示例

向 MCP 客户端提出请求：

• “从蓝色生成一个单色配色方案”
• “使用 #ff6b35 创建一个包含 7 种颜色的互补色调色板”
• “我需要一个基于 rgb(120,80,200) 的类似色方案”

输出格式

每个工具都会返回结构化 JSON，其中包含：

• 方案模式和种子颜色
• 生成颜色数组，包含 hex、RGB、HSL 值
• 颜色名称和位置

调试

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector node ./build/index.js

项目结构

• src/index.ts：服务主入口
• src/tools/index.ts：配色方案生成工具
• src/prompts/index.ts：用法指导提示词
• build/：编译后的 TypeScript 输出