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 許可證。

💪 貢獻指南

歡迎貢獻代碼！如果您有改進建議，請隨時提交拉取請求或打開問題。