README.md•2.88 kB
# Color Scheme Generator MCP Server
This is a Model Context Protocol (MCP) server that generates harmonious color schemes using The Color API. It provides multiple color scheme generation tools for creating beautiful and cohesive color palettes for design projects.
## Features
The server provides 8 different color scheme generation tools:
1. **Monochrome Schemes**: Variations of a single hue
- Standard monochrome
- Dark monochrome
- Light monochrome
2. **Color Wheel Based Schemes**:
- **Analogic**: Adjacent colors on the color wheel for harmonious designs
- **Complement**: Opposite colors for high contrast
- **Analogic Complement**: Combination of analogic and complement
- **Triad**: Three evenly spaced colors for balanced palettes
- **Quad**: Four evenly spaced colors for diverse palettes
## Prerequisites
- Node.js (v18 or later)
- npm, yarn, or pnpm
- An MCP client (e.g., Claude Desktop, Cursor)
## Installation
1. **Clone and install dependencies:**
```bash
git clone <repository-url>
cd colors-mcp-server
npm install
```
2. **Build the server:**
```bash
npm run build
```
3. **Configure your MCP client:**
For Claude Desktop (`claude_desktop_config.json`):
```json
{
"mcpServers": {
"color-scheme-generator": {
"command": "node",
"args": ["/full/path/to/colors-mcp-server/build/index.js"]
}
}
}
```
For Cursor:
- Go to Settings > MCP > Add new global MCP server
- Use the same configuration as above
## Usage
### Color Input Formats
The server accepts colors in multiple formats:
- **Hex**: `"098765"` or `"#098765"`
- **RGB**: `"0,71,171"` or `"rgb(0,71,171)"`
- **HSL**: `"215,100%,34%"` or `"hsl(215,100%,34%)"`
### Parameters
- `color`: The seed color (required)
- `count`: Number of colors to generate (optional, default: 5, range: 3-10)
### Available Tools
- `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`
### Example Usage
Ask your MCP client:
- "Generate a monochrome color scheme from blue"
- "Create a complementary palette using #ff6b35 with 7 colors"
- "I need an analogic scheme from rgb(120,80,200)"
## Output Format
Each tool returns a structured JSON with:
- Scheme mode and seed color
- Array of generated colors with hex, RGB, HSL values
- Color names and positions
## Debugging
Use the MCP Inspector to debug:
```bash
npx @modelcontextprotocol/inspector node ./build/index.js
```
## Project Structure
- `src/index.ts`: Main server entry point
- `src/tools/index.ts`: Color scheme generation tools
- `src/prompts/index.ts`: Usage guidance prompts
- `build/`: Compiled TypeScript output