Palettemcp

🚀 PaletteMCP - カラーコードから色名への変換ツール

PaletteMCPは、Go言語で書かれたコマンドラインツールです。16進数のカラーコードを入力として受け取り、事前定義されたCSSカラーのリストから最も近い色名を返します。出力はJSON形式で提供されるため、他のスクリプトやシステムとの統合が容易です。

✨ 主な機能

• 任意の16進数カラーコードを最も近い色名に変換します。
• クリーンで機械可読なJSON形式で出力します。
• 標準的なCSSカラーの包括的なリストを含んでいます。
• シンプルで使いやすいコマンドラインインターフェースを備えています。

📦 インストール

このツールを使用するには、システムにGoがインストールされている必要があります。

1. リポジトリをクローンする（Gitリポジトリにある場合）か、既存のファイルを使用します。
2. 実行ファイルをビルドします。

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

事前ビルド済みバイナリのダウンロード

様々なオペレーティングシステムとアーキテクチャ用の事前ビルド済みバイナリは、GitHub Releasesページから直接ダウンロードできます。 [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

# パスの通ったディレクトリに移動する（例：/usr/local/bin）
sudo mv palette-mcp /usr/local/bin/

Windows

1. GitHub Releasesページから適切な .exe ファイルをダウンロードします（例：palette-mcp_windows_amd64.exe）。
2. ダウンロードしたファイルを palette-mcp.exe にリネームします。
3. palette-mcp.exe をシステムの PATH 環境変数に含まれるディレクトリに移動します。一般的な方法は、ユーザーディレクトリに bin フォルダを作成し（例：C:\Users\YourUser\bin）、それを PATH に追加することです。

💻 使用例

基本的な使用法

palette-mcp はコマンドラインツールとして、またはGemini Model Context Protocol (MCP) サーバーとして実行できます。

コマンドラインツールとしての使用

ターミナルからツールを実行し、16進数のカラーコード（# プレフィックス有りまたは無し）を引数として渡します。

./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 引数を使用します。

Stdioトランスポート

これはデフォルトのトランスポート方法で、server 引数でサーバーを実行すると使用されます。

# Stdioを使用してサーバーを起動する
./palette-mcp server

HTTPトランスポート

カスタムポートを指定できるHTTPトランスポートでサーバーを実行することもできます。

# デフォルトポート8080で起動する
./palette-mcp serve-http

# カスタムポート（例：9000）で起動する
./palette-mcp serve-http 9000

SSE (Server-Sent Events) トランスポート

サーバーを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: 16進数のカラーコードから色に関する情報を取得します。
  • パラメータ: hexCode（文字列、例：#FF0000）

Gemini CLIの使用例（概念的）

設定が完了した後、Gemini CLIを介してツールと対話できます。たとえば、以下のように質問することができます。 What is the name of the color #00BFFF? Geminiモデルが get_color_info ツールを使用することを決定した場合、それを実行して結果を提供します。

Forge MCPとの統合

PaletteMCP は forge mcp ワークフローに簡単に統合でき、色名の検索機能を提供します。palette-mcp を forge 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 に渡す16進数カラーコードのプレースホルダーです。二重の中括弧 {{...}} は 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 を16進数コードで実行する
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ライセンスの下でライセンスされています。

コントリビューション

コントリビューションは大歓迎です！改善提案がある場合は、プルリクエストを送信するか、イシューを開いてください。