PaintColorHQ Color Match

PaintColorHQ — 跨品牌涂料颜色匹配（MCP 服务）

一个托管的 Model Context Protocol 服务，可在 13 个品牌的 26,000 多种涂料颜色中，为任意十六进制颜色值找到最接近的实际可购买颜色，并使用 CIEDE2000（Delta-E）进行评分。

无需安装，也无需 API 密钥。这是一个远程服务——让任意 MCP 客户端连接到此端点即可。

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

传输方式：无状态 Streamable HTTP。身份验证：无。

工具

共有三个工具。Agent 如果知道颜色名称，可调用 find_paint_color 查询其十六进制值，然后调用 match_paint_color 查找其他品牌的对应颜色。

find_paint_color

按名称、编号或两者查询涂料颜色，也可在查询中指定品牌。

参数	必填	说明
query	是	名称和/或编号，例如 Agreeable Gray、SW 7029、HC-154、Repose Gray sherwin williams。
brand	否	限定为 list_brands 返回的某个品牌 slug。
limit	否	颜色数量，1–10（默认 5）。

返回品牌、颜色名称、颜色编号、十六进制值、销售状态（在售、已退市或已停产），以及颜色页面链接。

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

list_brands

无参数。返回 13 个品牌及其他工具接受的品牌 slug、品牌名称和颜色数量。

match_paint_color

查找与十六进制颜色值最接近的跨品牌涂料颜色。

参数	必填	说明
hex	是	6 位十六进制值，可带或不带 #（例如 7F9B8E）。
brand	否	限定为某个品牌 slug（sherwin-williams、benjamin-moore、behr、valspar、ppg、dunn-edwards 等）。
limit	否	跨品牌匹配数量，1–10（默认 10）。

返回易读的摘要以及 structuredContent——每个匹配结果包含品牌、颜色名称、颜色编号、十六进制值、接近程度标签、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。涂料颜色名称和编号是其各自制造商的商标；本项目与任何涂料品牌均无关联，也未获其认可。