📦

Spectra MCP

Name: Spectra MCP
Rating: 1.7

A powerful MCP server for converting colors between different color spaces and formats. Built with FastMCP and powered by the coloraide library.

0 installs

Trust: 34 — Low

Devtools

Ask AI about Spectra MCP

I know everything about Spectra MCP. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

🎨 Spectra MCP Server

A powerful Model Context Protocol (MCP) server for converting colors between different color spaces and formats. Built with FastMCP and powered by the coloraide library.

🌐 Hosted Deployment

Spectra is now available as a hosted service! No installation required - integrate directly with any MCP client that supports remote HTTP servers.

Server URL: https://spectra-mcp.fastmcp.app/mcp

Simply add the URL to your MCP client configuration and start using color conversion tools immediately.

Overview

Spectra provides seamless color conversion capabilities through MCP tools, enabling AI assistants and applications to convert colors between various formats including RGB, HEX, HSL, and OKLCH color spaces. This server is ideal for design tools, theme generators, and any application requiring robust color manipulation.

Why Spectra?

Large Language Models (LLMs) struggle with converting colors between different formats in a deterministic way. Even seemingly simple conversions like #ff8080 to RGB or OKLCH to HEX can produce inconsistent or incorrect results when attempted through pure reasoning. Spectra solves this problem by providing reliable, deterministic color conversion tools that AI assistants can call, ensuring accurate and consistent color transformations every time.

Features

🌐 Hosted Service: Available remotely at https://spectra-mcp.fastmcp.app/mcp - no installation needed
Multiple Color Space Support: Convert between RGB, HEX, HSL, and OKLCH color spaces
Bidirectional Conversions: Convert colors in any direction between supported formats
High-Quality Conversions: Powered by the coloraide library for accurate color science
MCP Protocol: Standardized interface for integration with AI assistants and tools
HTTP Transport: Supports remote HTTP MCP servers for seamless integration

Supported Conversions

The following table shows all supported color format conversions:

From \ To	RGB	HEX	HSL	OKLCH
RGB	—	✅	✅	✅
HEX	✅	—	✅	✅
HSL	✅	✅	—	✅
OKLCH	✅	✅	✅	—

All conversions are bidirectional—you can convert between any two formats in either direction.

🛠️ Installation

Requirements

Cursor, Claude Code, VSCode, Windsurf or another MCP Client

Install in Cursor

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Pasting the following configuration into your Cursor ~/.cursor/mcp.json file is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See Cursor MCP docs for more info.

Since Cursor 1.0, you can click the install button at the top of this README for instant one-click installation.

{
  "mcpServers": {
    "spectra": {
      "url": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}

Install in Claude Code

Run this command. See Claude Code MCP docs for more info.

claude mcp add --transport http spectra https://spectra-mcp.fastmcp.app/mcp

Install in Amp

Run this command in your terminal. See Amp MCP docs for more info.

amp mcp add spectra https://spectra-mcp.fastmcp.app/mcp

Install in Windsurf

Add this to your Windsurf MCP config file. See Windsurf MCP docs for more info.

{
  "mcpServers": {
    "spectra": {
      "serverUrl": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}

Install in VS Code

Add this to your VS Code MCP config file. See VS Code MCP docs for more info.

"mcp": {
  "servers": {
    "spectra": {
      "type": "http",
      "url": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}

Install in Cline

You can easily install Spectra through the Cline MCP Server Marketplace by following these instructions:

Open Cline.
Click the hamburger menu icon (☰) to enter the MCP Servers section.
Use the search bar within the Marketplace tab to find Spectra.
Click the Install button.

Or you can directly edit MCP servers configuration:

Open Cline.
Click the hamburger menu icon (☰) to enter the MCP Servers section.
Choose Remote Servers tab.
Click the Edit Configuration button.
Add spectra to mcpServers:

{
  "mcpServers": {
    "spectra": {
      "url": "https://spectra-mcp.fastmcp.app/mcp",
      "type": "streamableHttp"
    }
  }
}

Install in Zed

Add this to your Zed settings.json. See Zed Context Server docs for more info.

Note: Zed currently supports local MCP servers only. For remote server support, please check Zed's documentation for updates or use another MCP client that supports remote HTTP servers.

Install in Augment Code

Note: Augment Code currently supports local MCP servers only. For remote server support, please check Augment Code's documentation for updates or use another MCP client that supports remote HTTP servers.

Install in Roo Code

Add this to your Roo Code MCP configuration file. See Roo Code MCP docs for more info.

{
  "mcpServers": {
    "spectra": {
      "type": "streamable-http",
      "url": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}

Install in Claude Desktop

Open Claude Desktop and navigate to Settings > Connectors > Add Custom Connector. Enter the name as Spectra and the remote MCP server URL as https://spectra-mcp.fastmcp.app/mcp.

Install in Opencode

Add this to your Opencode configuration file. See Opencode MCP docs for more info.

"mcp": {
  "spectra": {
    "type": "remote",
    "url": "https://spectra-mcp.fastmcp.app/mcp",
    "enabled": true
  }
}

Install in OpenAI Codex

See OpenAI Codex for more information.

Add the following configuration to your OpenAI Codex MCP server settings:

[mcp_servers.spectra]
url = "https://spectra-mcp.fastmcp.app/mcp"

Install in JetBrains AI Assistant

Note: JetBrains AI Assistant currently supports local MCP servers only. For remote server support, please check JetBrains' documentation for updates or use another MCP client that supports remote HTTP servers.

Install in Kiro

Note: Kiro currently supports local MCP servers only. For remote server support, please check Kiro's documentation for updates or use another MCP client that supports remote HTTP servers.

Install in Trae

Use the Add manually feature and fill in the JSON configuration information for that MCP server.

For more details, visit the Trae documentation.

{
  "mcpServers": {
    "spectra": {
      "url": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}

Install in LM Studio

Note: LM Studio currently supports local MCP servers only. For remote server support, please check LM Studio's documentation for updates or use another MCP client that supports remote HTTP servers.

Install in Visual Studio 2022

You can configure Spectra MCP in Visual Studio 2022 by following the Visual Studio MCP Servers documentation.

Add this to your Visual Studio MCP config file (see the Visual Studio docs for details):

{
  "inputs": [],
  "servers": {
    "spectra": {
      "type": "http",
      "url": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}

For more information and troubleshooting, refer to the Visual Studio MCP Servers documentation.

Install in Crush

Add this to your Crush configuration file. See Crush MCP docs for more info.

{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "spectra": {
      "type": "http",
      "url": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}

Install in BoltAI

Note: BoltAI currently supports local MCP servers only. For remote server support, please check BoltAI's documentation for updates or use another MCP client that supports remote HTTP servers.

Install in Warp

Note: Warp currently supports local MCP servers only. For remote server support, please check Warp's documentation for updates or use another MCP client that supports remote HTTP servers.

Install in Perplexity Desktop

Note: Perplexity Desktop currently supports local MCP servers only. For remote server support, please check Perplexity's documentation for updates or use another MCP client that supports remote HTTP servers.

💻 Development Setup (For Contributors)

If you want to contribute to Spectra or run it locally:

Prerequisites

Python 3.14 or higher
uv package manager (recommended)

Setup

Clone the repository:

git clone <repository-url>
cd spectra-mcp

Install dependencies using uv:

uv sync

Start the server:

uv run python main.py

The server will start on http://127.0.0.1:8000 by default.

API Reference

Tools

`oklch_to_rgb`

Convert an OKLCH color to an RGB color.

Parameters:

oklch (string): OKLCH color string (e.g., "oklch(0.7 0.2 180)")

Returns:

RGB color string (e.g., "rgb(255, 128, 128)")

`rgb_to_oklch`

Convert an RGB color to an OKLCH color.

Parameters:

rgb (string): RGB color string (e.g., "rgb(255, 128, 128)" or "255, 128, 128")

Returns:

OKLCH color string (e.g., "oklch(0.7 0.2 180)")

`hex_to_rgb`

Convert a hex color to an RGB color.

Parameters:

hex (string): Hex color string (e.g., "#ff8080" or "ff8080")

Returns:

RGB color string (e.g., "rgb(255, 128, 128)")

`rgb_to_hex`

Convert an RGB color to a hex color.

Parameters:

rgb (string): RGB color string (e.g., "rgb(255, 128, 128)" or "255, 128, 128")

Returns:

Hex color string (e.g., "#ff8080")

`oklch_to_hex`

Convert an OKLCH color to a hex color.

Parameters:

oklch (string): OKLCH color string (e.g., "oklch(0.7 0.2 180)")

Returns:

Hex color string (e.g., "#ff8080")

`hex_to_oklch`

Convert a hex color to an OKLCH color.

Parameters:

hex (string): Hex color string (e.g., "#ff8080" or "ff8080")

Returns:

OKLCH color string (e.g., "oklch(0.7 0.2 180)")

`rgb_to_hsl`

Convert an RGB color to an HSL color.

Parameters:

rgb (string): RGB color string (e.g., "rgb(255, 128, 128)" or "255, 128, 128")

Returns:

HSL color string (e.g., "hsl(0 100% 75%)")

`hsl_to_rgb`

Convert an HSL color to an RGB color.

Parameters:

hsl (string): HSL color string (e.g., "hsl(0 100% 75%)")

Returns:

RGB color string (e.g., "rgb(255, 128, 128)")

`oklch_to_hsl`

Convert an OKLCH color to an HSL color.

Parameters:

oklch (string): OKLCH color string (e.g., "oklch(0.7 0.2 180)")

Returns:

HSL color string (e.g., "hsl(0 100% 75%)")

`hsl_to_oklch`

Convert an HSL color to an OKLCH color.

Parameters:

hsl (string): HSL color string (e.g., "hsl(0 100% 75%)")

Returns:

OKLCH color string (e.g., "oklch(0.7 0.2 180)")

`hex_to_hsl`

Convert a hex color to an HSL color.

Parameters:

hex (string): Hex color string (e.g., "#ff8080" or "ff8080")

Returns:

HSL color string (e.g., "hsl(0 100% 75%)")

`hsl_to_hex`

Convert an HSL color to a hex color.

Parameters:

hsl (string): HSL color string (e.g., "hsl(0 100% 75%)")

Returns:

Hex color string (e.g., "#ff8080")

Examples

Converting OKLCH to RGB

Input: oklch(0.7 0.2 180)
Output: rgb(255, 128, 128)

Converting RGB to OKLCH

Input: rgb(255, 128, 128)
Output: oklch(0.7 0.2 180)

Converting HEX to RGB

Input: #ff8080
Output: rgb(255, 128, 128)

Converting RGB to HEX

Input: rgb(255, 128, 128)
Output: #ff8080

Converting OKLCH to HEX

Input: oklch(0.7 0.2 180)
Output: #ff8080

Converting HEX to OKLCH

Input: #ff8080
Output: oklch(0.7 0.2 180)

Converting RGB to HSL

Input: rgb(255, 128, 128)
Output: hsl(0 100% 75%)

Converting HSL to RGB

Input: hsl(0 100% 75%)
Output: rgb(255, 128, 128)

Converting OKLCH to HSL

Input: oklch(0.7 0.2 180)
Output: hsl(0 100% 75%)

Converting HSL to OKLCH

Input: hsl(0 100% 75%)
Output: oklch(0.7 0.2 180)

Converting HEX to HSL

Input: #ff8080
Output: hsl(0 100% 75%)

Converting HSL to HEX

Input: hsl(0 100% 75%)
Output: #ff8080

Configuration

Remote/Hosted Server

No configuration needed! The hosted service at https://spectra-mcp.fastmcp.app/mcp is ready to use.

Local Development Server

For local development, server configuration can be modified in fastmcp.json:

Port: Change the port value (default: 8000)
Host: Change the host value (default: 127.0.0.1)
Log Level: Adjust log_level (default: DEBUG)
Environment: Modify environment variables as needed

Dependencies

coloraide (>=5.1): Advanced color manipulation library
fastmcp (>=2.13.0.2): Fast MCP server framework

Acknowledgments

Built with FastMCP
Color conversions powered by coloraide

Spectra MCP

Reviews

Documentation

🎨 Spectra MCP Server

🌐 Hosted Deployment

Overview

Why Spectra?

Features

Supported Conversions

🛠️ Installation

Requirements

💻 Development Setup (For Contributors)

Prerequisites

Setup

API Reference

Tools

oklch_to_rgb

rgb_to_oklch

hex_to_rgb

rgb_to_hex

oklch_to_hex

hex_to_oklch

rgb_to_hsl

hsl_to_rgb

oklch_to_hsl

hsl_to_oklch

hex_to_hsl

hsl_to_hex

Examples

Converting OKLCH to RGB

Converting RGB to OKLCH

Converting HEX to RGB

Converting RGB to HEX

Converting OKLCH to HEX

Converting HEX to OKLCH

Converting RGB to HSL

Converting HSL to RGB

Converting OKLCH to HSL

Converting HSL to OKLCH

Converting HEX to HSL

Converting HSL to HEX

Configuration

Remote/Hosted Server

Local Development Server

Dependencies

Acknowledgments

Security Checklist

`oklch_to_rgb`

`rgb_to_oklch`

`hex_to_rgb`

`rgb_to_hex`

`oklch_to_hex`

`hex_to_oklch`

`rgb_to_hsl`

`hsl_to_rgb`

`oklch_to_hsl`

`hsl_to_oklch`

`hex_to_hsl`

`hsl_to_hex`