Spectra MCP

🎨 Spectra MCP服务器

一个强大的 模型上下文协议（MCP） 用于在不同颜色空间和格式之间转换颜色的服务器。采用FastMCP构建，并由coloraide库提供支持。

🌐 托管部署

Spectra现在可以作为托管服务使用！ 无需安装-直接与支持远程HTTP服务器的任何MCP客户端集成。

服务器URL: https://spectra-mcp.fastmcp.app/mcp

只需将URL添加到MCP客户端配置中，即可立即开始使用颜色转换工具。

概述

Spectra通过MCP工具提供无缝的颜色转换功能，使AI助手和应用程序能够在各种格式之间转换颜色，包括RGB、HEX、HSL和OKLCH颜色空间。此服务器非常适合设计工具、主题生成器和任何需要强大颜色操作的应用程序。

为什么选择Spectra？

大型语言模型（LLM）难以以确定性的方式在不同格式之间转换颜色。即使是看似简单的转换，比如 #ff8080 当通过纯推理尝试时，RGB或OKLCH到HEX可能会产生不一致或不正确的结果。Spectra通过提供AI助手可以调用的可靠、确定的颜色转换工具来解决这个问题，确保每次都能进行准确和一致的颜色转换。

特性

• 🌐 托管服务：可远程访问 https://spectra-mcp.fastmcp.app/mcp -无需安装
• 支持多种颜色空间：在RGB、HEX、HSL和OKLCH颜色空间之间转换
• 双向转换：在支持的格式之间任意方向转换颜色
• 高质量转换：由coloraide库提供支持，用于精确的颜色科学
• MCP协议：与人工智能助手和工具集成的标准化界面
• HTTP传输：支持远程HTTP MCP服务器，实现无缝集成

支持的转换

下表显示了所有支持的颜色格式转换：

所有转换都是双向的——您可以在任何方向上在任何两种格式之间进行转换。

🛠️ 安装

需求

• Cursor、Claude Code、VSCode、Windsurf或其他MCP客户端

Install in Cursor

首选 Settings -> Cursor Settings -> MCP -> Add new global MCP server

将以下配置粘贴到游标中 ~/.cursor/mcp.json 文件是推荐的方法。您还可以通过创建以下内容在特定项目中安装 .cursor/mcp.json 在您的项目文件夹中。看 光标MCP文档 了解更多信息。

从Cursor 1.0开始，您可以单击此README顶部的安装按钮进行即时一键安装。


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

Install in Claude Code

运行此命令。看 克劳德代码MCP文档 了解更多信息。

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

Install in Amp

在终端中运行此命令。看 Amp MCP文档 了解更多信息。

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

Install in Windsurf

将此添加到您的Windsurf MCP配置文件中。看 Windsurf MCP文件 了解更多信息。

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

Install in VS Code

将此添加到您的VS Code MCP配置文件中。看 VS代码MCP文档 了解更多信息。

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

Install in Cline

您可以通过以下方式轻松安装Spectra Cline MCP服务器市场 按照以下说明：

1. 打开 克莱恩.
2. 点击汉堡菜单图标（☰）进入 MCP服务器 部分。
3. 使用搜索栏 市场 选项卡查找 _光谱_.
4. 点击 安装 按钮。

或者您可以直接编辑MCP服务器配置：

1. 打开 克莱恩.
2. 点击汉堡菜单图标（☰）进入 MCP服务器 部分。
3. 选择 远程服务器 选项卡。
4. 点击 编辑配置 按钮。
5. 添加光谱 mcpServers:

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

Install in Zed

将此添加到您的Zed settings.json。参见 Zed上下文服务器文档 了解更多信息。

注意：Zed目前仅支持本地MCP服务器。对于远程服务器支持，请查看Zed的文档以获取更新，或使用支持远程HTTP服务器的另一个MCP客户端。

Install in Augment Code

注意：Augment Code目前仅支持本地MCP服务器。对于远程服务器支持，请查看Augment Code的文档以获取更新，或使用支持远程HTTP服务器的另一个MCP客户端。

Install in Roo Code

将此添加到Roo Code MCP配置文件中。看 Roo代码MCP文档 了解更多信息。

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

Install in Claude Desktop

打开Claude Desktop，导航到“设置”>“连接器”>“添加自定义连接器”。输入名称如下 Spectra 远程MCP服务器URL为 https://spectra-mcp.fastmcp.app/mcp.

Install in Opencode

将其添加到您的Opencode配置文件中。看 开放代码MCP文档 了解更多信息。

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

Install in OpenAI Codex

看 OpenAI Codex 了解更多信息。

将以下配置添加到OpenAI Codex MCP服务器设置中：

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

Install in JetBrains AI Assistant

注意：JetBrains AI Assistant目前仅支持本地MCP服务器。对于远程服务器支持，请查看JetBrains的文档以获取更新，或使用支持远程HTTP服务器的另一个MCP客户端。

Install in Kiro

注意：Kiro目前仅支持本地MCP服务器。对于远程服务器支持，请查看Kiro的文档以获取更新，或使用支持远程HTTP服务器的另一个MCP客户端。

Install in Trae

使用手动添加功能并填写该MCP服务器的JSON配置信息。

有关更多详细信息，请访问 Trae文件.

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

Install in LM Studio

注意：LM Studio目前仅支持本地MCP服务器。对于远程服务器支持，请查看LM Studio的文档以获取更新，或使用支持远程HTTP服务器的另一个MCP客户端。

Install in Visual Studio 2022

您可以在Visual Studio 2022中按照以下步骤配置Spectra MCP Visual Studio MCP服务器文档.

将此添加到Visual Studio MCP配置文件中（请参阅 Visual Studio文档 详细信息）：

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

有关更多信息和故障排除，请参阅 Visual Studio MCP服务器文档.

Install in Crush

将此添加到您的Crush配置文件中。看 粉碎MCP文档 了解更多信息。

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

Install in BoltAI

注意：BoltAI目前仅支持本地MCP服务器。对于远程服务器支持，请查看BoltAI的文档以获取更新，或使用支持远程HTTP服务器的另一个MCP客户端。

Install in Warp

注意：Warp目前仅支持本地MCP服务器。对于远程服务器支持，请查看Warp的文档以获取更新，或使用支持远程HTTP服务器的另一个MCP客户端。

Install in Perplexity Desktop

注意：困惑桌面目前仅支持本地MCP服务器。对于远程服务器支持，请查看Perplexity的文档以获取更新，或使用支持远程HTTP服务器的另一个MCP客户端。

______________________________________________________________________

💻 开发设置（供贡献者使用）

如果您想为Spectra做出贡献或在本地运行它：

先决条件

• Python 3.14或更高版本
• 紫外线 包管理器（推荐）

设置

1. 克隆存储库：

git clone 
cd spectra-mcp

1. 使用uv安装依赖项：

uv sync

1. 启动服务器：

uv run python main.py

服务器将于启动 http://127.0.0.1:8000 默认情况下。

API 参考

工具

oklch_to_rgb

将OKLCH颜色转换为RGB颜色。

参数：

• oklch （string）:OKLCH颜色串（例如。， "oklch(0.7 0.2 180)")

退货：

• RGB颜色串（例如。， "rgb(255, 128, 128)")

rgb_to_oklch

将RGB颜色转换为OKLCH颜色。

参数：

• rgb （string）：RGB颜色串（例如。， "rgb(255, 128, 128)" 或 "255, 128, 128")

退货：

• OKLCH颜色串（例如。， "oklch(0.7 0.2 180)")

hex_to_rgb

将十六进制颜色转换为RGB颜色。

参数：

• hex （string）：十六进制颜色字符串（例如。， "#ff8080" 或 "ff8080")

退货：

• RGB颜色串（例如。， "rgb(255, 128, 128)")

rgb_to_hex

将RGB颜色转换为十六进制颜色。

参数：

• rgb （string）：RGB颜色串（例如。， "rgb(255, 128, 128)" 或 "255, 128, 128")

退货：

• 十六进制颜色串（例如。， "#ff8080")

oklch_to_hex

将OKLCH颜色转换为十六进制颜色。

参数：

• oklch （string）:OKLCH颜色串（例如。， "oklch(0.7 0.2 180)")

退货：

• 十六进制颜色串（例如。， "#ff8080")

hex_to_oklch

将十六进制颜色转换为OKLCH颜色。

参数：

• hex （string）：十六进制颜色字符串（例如。， "#ff8080" 或 "ff8080")

退货：

• OKLCH颜色串（例如。， "oklch(0.7 0.2 180)")

rgb_to_hsl

将RGB颜色转换为HSL颜色。

参数：

• rgb （string）：RGB颜色串（例如。， "rgb(255, 128, 128)" 或 "255, 128, 128")

退货：

• HSL颜色串（例如。， "hsl(0 100% 75%)")

hsl_to_rgb

将HSL颜色转换为RGB颜色。

参数：

• hsl （string）：HSL颜色串（例如。， "hsl(0 100% 75%)")

退货：

• RGB颜色串（例如。， "rgb(255, 128, 128)")

oklch_to_hsl

将OKLCH颜色转换为HSL颜色。

参数：

• oklch （string）:OKLCH颜色串（例如。， "oklch(0.7 0.2 180)")

退货：

• HSL颜色串（例如。， "hsl(0 100% 75%)")

hsl_to_oklch

将HSL颜色转换为OKLCH颜色。

参数：

• hsl （string）：HSL颜色串（例如。， "hsl(0 100% 75%)")

退货：

• OKLCH颜色串（例如。， "oklch(0.7 0.2 180)")

hex_to_hsl

将十六进制颜色转换为HSL颜色。

参数：

• hex （string）：十六进制颜色字符串（例如。， "#ff8080" 或 "ff8080")

退货：

• HSL颜色串（例如。， "hsl(0 100% 75%)")

hsl_to_hex

将HSL颜色转换为十六进制颜色。

参数：

• hsl （string）：HSL颜色串（例如。， "hsl(0 100% 75%)")

退货：

• 十六进制颜色串（例如。， "#ff8080")

例子

将OKLCH转换为RGB

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

将RGB转换为OKLCH

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

将HEX转换为RGB

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

将RGB转换为HEX

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

将OKLCH转换为HEX

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

将HEX转换为OKLCH

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

将RGB转换为HSL

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

将HSL转换为RGB

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

将OKLCH转换为HSL

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

将HSL转换为OKLCH

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

将HEX转换为HSL

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

将HSL转换为HEX

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

配置

远程/托管服务器

无需配置！托管服务位于 https://spectra-mcp.fastmcp.app/mcp 已准备好使用。

本地开发服务器

对于本地开发，可以在中修改服务器配置 fastmcp.json:

• 端口：更改 port 值（默认值：8000）
• 主机：更改 host 值（默认值：127.0.0.1）
• 日志级别：调整 log_level （默认值：DEBUG）
• 环境：根据需要修改环境变量

依赖项

• 着色剂 （>=5.1）：高级颜色操作库
• fastmcp （>=2.13.0.2）：快速MCP服务器框架

致谢

• 内置 FastMCP
• 颜色转换由 着色剂