PaintColorHQ Color Match

PaintColorHQ — ブランド横断の塗料色マッチング（MCP サーバー）

ホスト型のModel Context Protocolサーバーです。任意の16進数カラー値に対し、26,000色以上を対象にCIEDE2000（Delta-E）でスコアを算出し、13ブランドの実際に購入可能な塗料色の中から最も近い色を見つけます。

インストールもAPIキーも不要です。リモートサーバーなので、任意のMCPクライアントからエンドポイントに接続するだけです。

https://www.paintcolorhq.com/api/mcp

トランスポート：ステートレスなStreamable HTTP。認証：なし。

ツール

ツールは3つです。色名を把握しているエージェントは、まずfind_paint_colorで16進数カラー値を取得し、続いてmatch_paint_colorで他ブランドの同等色を検索します。

find_paint_color

必要に応じてクエリにブランド名を含め、色名、番号、またはその両方から塗料色を検索します。

引数	必須	説明
query	はい	色名および／または番号。例：Agreeable Gray、SW 7029、HC-154、Repose Gray sherwin williams。
brand	いいえ	list_brandsが返すブランドのスラッグで、対象ブランドを絞り込みます。
limit	いいえ	色の件数。1～10（デフォルトは5）。

ブランド、色名、色番号、16進数カラー値、販売状況（現行、廃番、または販売終了）、色のページへのリンクを返します。

find_paint_color { "query": "SW 7029" }
→ 1. Agreeable Gray — Sherwin-Williams 7029 (#d1cbc1)

list_brands

引数はありません。ほかのツールで使用するスラッグ、ブランド名、色の登録数とともに、13ブランドを返します。

match_paint_color

16進数カラー値に最も近い、他ブランドの塗料色を検索します。

引数	必須	説明
hex	はい	6桁の16進数カラー値。#の有無は問いません（例：7F9B8E）。
brand	いいえ	ブランドのスラッグ（sherwin-williams、benjamin-moore、behr、valspar、ppg、dunn-edwardsなど）で対象ブランドを絞り込みます。
limit	いいえ	他ブランドの一致候補数。1～10（デフォルトは10）。

読みやすい概要とstructuredContentを返します。各候補には、ブランド、色名、色番号、16進数カラー値、近さを示すラベル、Delta-E、および色のページへのリンクが含まれます。*「Sherwin-WilliamsのRepose Grayに相当するBehrの色は？」*といった質問に答えられます。

例

match_paint_color { "hex": "7F9B8E", "limit": 3 }
→ 1. Sioux Falls — Benjamin Moore 705 (#80968f) — Very similar
  2. Eucalyptus — Behr QE-44 (#8c9f97) — Very similar
  3. Phoenix Tears — Valspar 8003-35D (#8da898) — Very similar

接続

Claude Code

claude mcp add --transport http paintcolorhq https://www.paintcolorhq.com/api/mcp

リモートURLに対応するクライアント（Claude Desktopコネクター、Cursorなど）

{
  "mcpServers": {
    "paintcolorhq": {
      "type": "http",
      "url": "https://www.paintcolorhq.com/api/mcp"
    }
  }
}

stdioのみ対応するクライアント（mcp-remote経由）

{
  "mcpServers": {
    "paintcolorhq": {
      "command": "npx",
      "args": ["mcp-remote", "https://www.paintcolorhq.com/api/mcp"]
    }
  }
}

動作確認

npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP → URL: https://www.paintcolorhq.com/api/mcp → Connect → Tools

# Or a raw round-trip:
curl -s https://www.paintcolorhq.com/api/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"match_paint_color","arguments":{"hex":"7F9B8E"}}}'

マッチングの仕組み

すべての色をCIE LAB色空間に変換し、サーバーはユーザーの色と13ブランドのカタログにある26,000色以上との間のCIEDE2000 Delta-Eを計算します。これは塗料およびコーティング製造で使われている知覚色差の標準で、各ブランドで最も近い色を返します。画面上で一致して見えても、照明の下では壁の色が異なって見えることがあるため、最終的な色を決める前に実物のサンプルで確認してください。

ソースとリンク

• サーバーのソースはメインサイトのリポジトリにあります：pcameron80/paintcolorhq → src/app/api/mcp/route.ts（ドキュメント：docs/mcp-server.md）
• 人間向けドキュメント：https://www.paintcolorhq.com/api
• 無料のRESTエンドポイント（キー不要）：https://www.paintcolorhq.com/api/color-match?hex=7F9B8E
• 無料の埋め込み可能なウィジェット：https://www.paintcolorhq.com/embed
• 有料プラン（バッチ処理＋色彩科学のフィールド）はRapidAPIで利用できます。

ライセンス

MIT — LICENSEを参照してください。塗料の色名と色番号は各メーカーの商標です。このプロジェクトは、いずれの塗料ブランドとも提携しておらず、各ブランドからの推奨も受けていません。