返回市场
光谱-mcp

光谱-mcp

作者:mwalterskirchen2 星标更新:2025-11-03

项目介绍

🎨 Spectra MCP Server

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

🌐 托管部署

**Spectra现在作为托管服务提供!**无需安装——可以直接与支持远程HTTP服务器的任何MCP客户端集成。

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

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

概述

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

为什么选择Spectra?

大型语言模型(LLMs)在以确定性方式在不同格式之间转换颜色时会遇到困难。即使是看似简单的转换,如从#ff8080到RGB或从OKLCH到HEX,仅通过纯推理尝试也可能产生不一致或错误的结果。Spectra通过提供可靠的、确定性的颜色转换工具解决了这个问题,确保每次都能准确且一致地进行颜色变换。

功能

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

支持的转换

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

从 \ 到RGBHEXHSLOKLCH
RGB
HEX
HSL
OKLCH

所有转换都是双向的——可以在任意两个格式之间进行任意方向的转换。

🛠️ 安装

要求

  • Cursor, Claude Code, VSCode, Windsurf 或其他MCP客户端
<details> <summary><b>在Cursor中安装</b></summary>

前往:设置 -> Cursor设置 -> MCP -> 添加新的全局MCP服务器

推荐的方法是将以下配置粘贴到您的Cursor ~/.cursor/mcp.json 文件中。您也可以通过在项目文件夹中创建 .cursor/mcp.json 来在特定项目中安装。更多信息请参阅 Cursor MCP文档

自Cursor 1.0起,您可以点击此README顶部的安装按钮,实现一键安装。

安装MCP服务器

{
  "mcpServers": {
    "spectra": {
      "url": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}
</details> <details> <summary><b>在Claude Code中安装</b></summary>

运行以下命令。更多信息请参阅 Claude Code MCP文档

claude mcp add --transport http spectra https://spectra-mcp.fastmcp.app/mcp
</details> <details> <summary><b>在Amp中安装</b></summary>

在终端中运行以下命令。更多信息请参阅 Amp MCP文档

amp mcp add spectra https://spectra-mcp.fastmcp.app/mcp
</details> <details> <summary><b>在Windsurf中安装</b></summary>

将以下内容添加到您的Windsurf MCP配置文件中。更多信息请参阅 Windsurf MCP文档

{
  "mcpServers": {
    "spectra": {
      "serverUrl": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}
</details> <details> <summary><b>在VS Code中安装</b></summary>

将以下内容添加到您的VS Code MCP配置文件中。更多信息请参阅 VS Code MCP文档

"mcp": {
  "servers": {
    "spectra": {
      "type": "http",
      "url": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}
</details> <details> <summary><b>在Cline中安装</b></summary>

您可以通过遵循以下步骤,在Cline MCP服务器市场轻松安装Spectra:

  1. 打开Cline
  2. 点击汉堡菜单图标(☰),进入MCP服务器部分。
  3. 使用市场标签中的搜索栏找到_Spectra_。
  4. 点击安装按钮。

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

  1. 打开Cline
  2. 点击汉堡菜单图标(☰),进入MCP服务器部分。
  3. 选择远程服务器标签。
  4. 点击编辑配置按钮。
  5. 将spectra添加到mcpServers
{
  "mcpServers": {
    "spectra": {
      "url": "https://spectra-mcp.fastmcp.app/mcp",
      "type": "streamableHttp"
    }
  }
}
</details> <details> <summary><b>在Zed中安装</b></summary>

将以下内容添加到您的Zed settings.json 中。更多信息请参阅 Zed上下文服务器文档

注意:Zed目前仅支持本地MCP服务器。对于远程服务器的支持,请查看Zed的文档更新或使用支持远程HTTP服务器的其他MCP客户端。

</details> <details> <summary><b>在Augment Code中安装</b></summary>

注意:Augment Code目前仅支持本地MCP服务器。对于远程服务器的支持,请查看Augment Code的文档更新或使用支持远程HTTP服务器的其他MCP客户端。

</details> <details> <summary><b>在Roo Code中安装</b></summary>

将以下内容添加到您的Roo Code MCP配置文件中。更多信息请参阅 Roo Code MCP文档

{
  "mcpServers": {
    "spectra": {
      "type": "streamable-http",
      "url": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}
</details> <details> <summary><b>在Claude Desktop中安装</b></summary>

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

</details> <details> <summary><b>在Opencode中安装</b></summary>

将以下内容添加到您的Opencode配置文件中。更多信息请参阅 Opencode MCP文档

"mcp": {
  "spectra": {
    "type": "remote",
    "url": "https://spectra-mcp.fastmcp.app/mcp",
    "enabled": true
  }
}
</details> <details> <summary><b>在OpenAI Codex中安装</b></summary>

请参阅 OpenAI Codex 获取更多信息。

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

[mcp_servers.spectra]
url = "https://spectra-mcp.fastmcp.app/mcp"
</details> <details> <summary><b>在JetBrains AI Assistant中安装</b></summary>

注意:JetBrains AI Assistant目前仅支持本地MCP服务器。对于远程服务器的支持,请查看JetBrains的文档更新或使用支持远程HTTP服务器的其他MCP客户端。

</details> <details> <summary><b>在Kiro中安装</b></summary>

注意:Kiro目前仅支持本地MCP服务器。对于远程服务器的支持,请查看Kiro的文档更新或使用支持远程HTTP服务器的其他MCP客户端。

</details> <details> <summary><b>在Trae中安装</b></summary>

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

更多详情,请访问 Trae文档

{
  "mcpServers": {
    "spectra": {
      "url": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}
</details> <details> <summary><b>在LM Studio中安装</b></summary>

注意:LM Studio目前仅支持本地MCP服务器。对于远程服务器的支持,请查看LM Studio的文档更新或使用支持远程HTTP服务器的其他MCP客户端。

</details> <details> <summary><b>在Visual Studio 2022中安装</b></summary>

您可以通过遵循 Visual Studio MCP服务器文档,在Visual Studio 2022中配置Spectra MCP。

将以下内容添加到您的Visual Studio MCP配置文件中(详情请参阅 Visual Studio文档):

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

更多详情和故障排除,请参阅 Visual Studio MCP服务器文档

</details> <details> <summary><b>在Crush中安装</b></summary>

将以下内容添加到您的Crush配置文件中。更多信息请参阅 Crush MCP文档

{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "spectra": {
      "type": "http",
      "url": "https://spectra-mcp.fastmcp.app/mcp"
    }
  }
}
</details> <details> <summary><b>在BoltAI中安装</b></summary>

注意:BoltAI目前仅支持本地MCP服务器。对于远程服务器的支持,请查看BoltAI的文档更新或使用支持远程HTTP服务器的其他MCP客户端。

</details> <details> <summary><b>在Warp中安装</b></summary>

注意:Warp目前仅支持本地MCP服务器。对于远程服务器的支持,请查看Warp的文档更新或使用支持远程HTTP服务器的其他MCP客户端。

</details> <details> <summary><b>在Perplexity Desktop中安装</b></summary>

注意:Perplexity Desktop目前仅支持本地MCP服务器。对于远程服务器的支持,请查看Perplexity的文档更新或使用支持远程HTTP服务器的其他MCP客户端。

</details>

💻 开发环境设置(供贡献者使用)

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

先决条件

  • Python 3.14或更高版本
  • uv 包管理器(推荐)

设置

  1. 克隆仓库:
git clone <repository-url>
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 (字符串): OKLCH颜色字符串(例如,"oklch(0.7 0.2 180)"

返回值:

  • RGB颜色字符串(例如,"rgb(255, 128, 128)"

rgb_to_oklch

将RGB颜色转换为OKLCH颜色。

参数:

  • rgb (字符串): RGB颜色字符串(例如,"rgb(255, 128, 128)""255, 128, 128"

返回值:

  • OKLCH颜色字符串(例如,"oklch(0.7 0.2 180)"

hex_to_rgb

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

参数:

  • hex (字符串): 十六进制颜色字符串(例如,"#ff8080""ff8080"

返回值:

  • RGB颜色字符串(例如,"rgb(255, 128, 128)"

rgb_to_hex

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

参数:

  • rgb (字符串): RGB颜色字符串(例如,"rgb(255, 128, 128)""255, 128, 128"

返回值:

  • 十六进制颜色字符串(例如,"#ff8080"

oklch_to_hex

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

参数:

  • oklch (字符串): OKLCH颜色字符串(例如,"oklch(0.7 0.2 180)"

返回值:

  • 十六进制颜色字符串(例如,"#ff8080"

hex_to_oklch

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

参数:

  • hex (字符串): 十六进制颜色字符串(例如,"#ff8080""ff8080"

返回值:

  • OKLCH颜色字符串(例如,"oklch(0.7 0.2 180)"

rgb_to_hsl

将RGB颜色转换为HSL颜色。

参数:

  • rgb (字符串): RGB颜色字符串(例如,"rgb(255, 128, 128)""255, 128, 128"

返回值:

  • HSL颜色字符串(例如,"hsl(0 100% 75%)"

hsl_to_rgb

将HSL颜色转换为RGB颜色。

参数:

  • hsl (字符串): HSL颜色字符串(例如,"hsl(0 100% 75%)"

返回值:

  • RGB颜色字符串(例如,"rgb(255, 128, 128)"

oklch_to_hsl

将OKLCH颜色转换为HSL颜色。

参数:

  • oklch (字符串): OKLCH颜色字符串(例如,"oklch(0.7 0.2 180)"

返回值:

  • HSL颜色字符串(例如,"hsl(0 100% 75%)"

hsl_to_oklch

将HSL颜色转换为OKLCH颜色。

参数:

  • hsl (字符串): HSL颜色字符串(例如,"hsl(0 100% 75%)"

返回值:

  • OKLCH颜色字符串(例如,"oklch(0.7 0.2 180)"

hex_to_hsl

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

参数:

  • hex (字符串): 十六进制颜色字符串(例如,"#ff8080""ff8080"

返回值:

  • HSL颜色字符串(例如,"hsl(0 100% 75%)"

hsl_to_hex

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

参数:

  • hsl (字符串): HSL颜色字符串(例如,"hsl(0 100% 75%)"

返回值:

  • 十六进制颜色字符串(例如,"#ff8080"

示例

将OKLCH转换为RGB

输入: oklch(0.7 0.2 180)
输出: rgb(255, 128, 128)

将RGB转换为OKLCH

输入: rgb(255,