Palettemcp

🚀 PaletteMCP - 十六进制颜色代码转名称转换器

PaletteMCP 是一个用 Go 语言编写的命令行工具，它可以接收十六进制颜色代码，并从预定义的 CSS 颜色列表中返回最匹配的颜色名称。输出以 JSON 格式提供，便于与其他脚本和系统集成。

🚀 快速开始

PaletteMCP 是一个强大且实用的工具，能够轻松将十六进制颜色代码转换为对应的颜色名称。以下是使用该工具的基本步骤和示例，助您快速上手。

✨ 主要特性

• 可将任何十六进制颜色代码转换为最接近的颜色名称。
• 以简洁、机器可读的 JSON 格式输出。
• 包含全面的标准 CSS 颜色列表。
• 拥有简单易用的命令行界面。

📦 安装指南

要使用此工具，您的系统需要安装 Go。

从源码构建

1. 克隆仓库（如果您将其存储在 Git 仓库中）或直接使用现有文件。
2. 构建可执行文件：

go build -o palette-mcp ./cmd/palette-mcp

下载预构建二进制文件

您可以直接从 GitHub 发布页面 下载适用于各种操作系统和架构的预构建二进制文件。 将 [VERSION] 替换为所需的发布版本（例如，v1.0.0）。

Linux / macOS

# 下载二进制文件（将 [OS] 和 [ARCH] 替换为您的系统信息，例如 linux_amd64、darwin_arm64）
wget https://github.com/kelvinzer0/PaletteMCP/releases/download/[VERSION]/palette-mcp_[OS]_[ARCH] -O palette-mcp

# 使其可执行
chmod +x palette-mcp

# 将其移动到系统 PATH 中的目录（例如，/usr/local/bin）
sudo mv palette-mcp /usr/local/bin/

Windows

1. 从 GitHub 发布页面 下载合适的 .exe 文件（例如，palette-mcp_windows_amd64.exe）。
2. 将下载的文件重命名为 palette-mcp.exe。
3. 将 palette-mcp.exe 移动到系统 PATH 环境变量包含的目录中。常见的做法是在用户目录下创建一个 bin 文件夹（例如，C:\Users\YourUser\bin），并将其添加到 PATH 中。

💻 使用示例

基础用法

palette-mcp 既可以作为命令行工具使用，也可以作为 Gemini 模型上下文协议（MCP）服务器运行。

命令行工具使用方法

在终端中运行该工具，将十六进制颜色代码（可带或不带 # 前缀）作为参数传递。

./palette-mcp #ff6347

示例（命令行工具）

输入：

./palette-mcp #ff6347

输出：

{
"hex": "#ff6347",
"name": "Tomato",
"rgb": "rgb(255, 99, 71)"
}

高级用法

Gemini MCP 服务器集成

palette-mcp 还可以作为 MCP 服务器运行，将其功能暴露给 Gemini CLI。这使得 Gemini 模型能够发现并执行 palette-mcp 的工具。

运行 MCP 服务器

要以服务器模式启动 palette-mcp，使用 server 参数。

标准输入输出传输

这是默认的传输方法，当您使用 server 参数运行服务器时会使用此方法。

# 使用标准输入输出启动服务器
./palette-mcp server

HTTP 传输

您也可以使用 HTTP 传输运行服务器，这样可以指定自定义端口。

# 在默认端口 8080 启动
./palette-mcp serve-http

# 在自定义端口（例如 9000）启动
./palette-mcp serve-http 9000

SSE（服务器发送事件）传输

要以 SSE 模式运行服务器，使用 -sse 标志。这将启动一个流式传输事件的 HTTP 服务器。

# 在默认端口 8080 以 SSE 模式启动
./palette-mcp -sse

# 在自定义端口（例如 9000）以 SSE 模式启动
./palette-mcp -sse -port 9000

如果您想继续使用终端，建议在后台运行服务器：

./palette-mcp serve-http &
# 或者使用自定义端口：
./palette-mcp serve-http 9000 &

# 对于 SSE 模式：
./palette-mcp -sse &
# 或者使用自定义端口：
./palette-mcp -sse -port 9000 &

配置 Gemini CLI

要使 Gemini CLI 能够连接到您的 palette-mcp 服务器，请在 settings.json 文件中添加以下配置。该文件可以在全局位置 ~/.gemini/settings.json 或项目的 .gemini/settings.json 中找到。

{
"theme": "ANSI Light",
"selectedAuthType": "oauth-personal",
"mcpServers": {
"get-color-info": {
"command": "/usr/local/bin/palette-mcp",
"args":["server"]
}
}
}

• paletteMcpServer：这是您在 Gemini CLI 中为 MCP 服务器指定的名称，您可以选择任何具有描述性的名称。
• httpUrl：palette-mcp 服务器监听的 URL。如果您在自定义端口启动服务器，请调整端口（例如，http://localhost:9000）。
• timeout：Gemini CLI 等待服务器响应的最长时间（以毫秒为单位）。

可用工具

配置完成且服务器运行后，Gemini CLI 将发现以下工具：

• echo：回显提供的消息。（用于演示的示例工具）
  • 参数：message（字符串）
• get_color_info：根据十六进制代码检索颜色信息。
  • 参数：hexCode（字符串，例如 #FF0000）

示例 Gemini CLI 使用（概念性）

设置完成后，您可以通过 Gemini CLI 与工具进行交互。例如，您可以询问： What is the name of the color #00BFFF? 如果 Gemini 模型决定使用 get_color_info 工具，它将执行该工具并提供结果。

与 Forge MCP 集成

PaletteMCP 可以轻松集成到 forge mcp 工作流中，以提供颜色名称查找功能。您可以在 forge mcp 配置中添加 palette-mcp 作为自定义命令。

将 PaletteMCP 添加到 Forge MCP

您可以使用 forge mcp add 命令或将其手动编辑到 .mcp.json 文件中，将 palette-mcp 添加到 forge mcp 配置中。

使用 forge mcp add（命令行）

# 示例：将 palette-mcp 添加为名为 'colorname' 的命令
forge mcp add --name colorname --command /path/to/palette-mcp --args "#{{hex_code}}"

• 将 /path/to/palette-mcp 替换为 palette-mcp 可执行文件的实际绝对路径。
• #{{hex_code}} 是 forge mcp 将传递给 palette-mcp 的十六进制颜色代码的占位符。双花括号 {{...}} 表示 forge mcp 中的变量或表达式。

手动 .mcp.json 配置

您也可以手动创建或修改 .mcp.json 文件。该文件可以位于本地项目目录或用户特定配置中。

{
"mcpServers": {
"colorname_tool": {
"command": "/usr/local/bin/palette-mcp",
"args": ["server"],
"description": "Converts a hex color code to its closest named color."
}
}
}

• colorname_tool：这是您通过 forge mcp 调用 palette-mcp 时使用的名称（例如，forge mcp run colorname_tool #RRGGBB）。
• command：palette-mcp 可执行文件的绝对路径。
• args：传递给 palette-mcp 的参数数组。"#{{hex_code}}" 是从 forge mcp 传递动态输入的常见模式。

示例 Forge MCP 使用

配置完成后，您可以在 forge mcp 工作流中使用 palette-mcp：

# 使用十六进制代码运行配置的 colorname_tool
forge mcp run colorname_tool "#00BFFF"

# 在多代理工作流中使用输出的示例（概念性）
# 假设 'forge mcp run colorname_tool' 输出 JSON
COLOR_INFO=$(forge mcp run colorname_tool "#FF0000")
COLOR_NAME=$(echo $COLOR_INFO | jq -r '.name')
echo "The color is: $COLOR_NAME"

• 注意：jq 命令是一个强大的命令行 JSON 处理器，您可能需要单独安装它（在 macOS 上使用 brew install jq，在 Debian/Ubuntu 上使用 sudo apt-get install jq）。

这种集成允许 forge mcp 在更大的自动化或多代理任务中利用 PaletteMCP 进行颜色代码到名称的转换。

🔧 技术细节

该工具通过计算输入颜色的 RGB 值与预定义列表中每种颜色的 RGB 值之间的欧几里得距离来确定“最接近”的颜色。距离最小的颜色被认为是最匹配的颜色。

📚 详细文档

颜色参考

以下表格列出了用于匹配的所有命名颜色。

📄 许可证

本项目采用 MIT 许可证。

💪 贡献指南

欢迎贡献代码！如果您有改进建议，请随时提交拉取请求或打开问题。