调色方案生成器 MCP 服务器

这是一个使用 The Color API 生成和谐调色方案的模型上下文协议（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：

   • 前往设置 > MCP > 添加新的全局 MCP 服务器
   • 使用上述相同的配置

使用方法

颜色输入格式

服务器接受多种格式的颜色输入：

• 十六进制："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，包括：

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

调试

使用 MCP Inspector 进行调试：

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

项目结构

• src/index.ts：主服务器入口点
• src/tools/index.ts：调色方案生成工具
• src/prompts/index.ts：使用指南提示
• build/：编译后的 TypeScript 输出