Color Pizza

mcp-color-pizza

Color Pizza MCP — 人にわかりやすい色名リストを使って、16 進数の色に名前を付けます。キー不要の Color Pizza API（https://api.color.pizza/v1）をラップしています。

Pipeworx の一部です。AI エージェントを 1875 以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。

ツール

ツール	説明
name_colors	1 つ以上の 16 進数カラーコードに最も近い、人にわかりやすい色名を検索します。先頭の # はあってもなくてもかまいません。複数の場合はカンマ区切りで指定します。入力ごとに最も近い名前付きカラーと、その標準 16 進数表記、RGB、知覚距離を返します。任意で命名リスト（例：「wikipedia」、「ntc」、「x11」、「html」、「japaneseTraditional」、「leCorbusier」、「bestOf」）を指定できます。既定値は「default」です。利用可能なリストを確認するには list_palettes を使ってください。
search_color_names	名前に部分文字列（例：「blue」、「rose」、「teal」）を含む名前付きカラーを検索します。一致した色名とその 16 進数コードを返します。任意で特定の命名リストに絞り込めます（list_palettes を参照）。
list_palettes	利用可能なすべての色名リスト（パレット）について、タイトル、説明、色の数、ライセンスを一覧表示します。name_colors と search_color_names の「list」引数で有効な値を確認する際に使います。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "color-pizza": {
      "url": "https://gateway.pipeworx.io/color-pizza/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/color-pizza/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できる一連のツール）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントでは、パック固有のツールに加えて、共通ツールがおよそ 30 個一覧表示されます。接続の initialize 応答には正確な範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な仕様であり、偶然に多重化されているわけではありません。メタツールを使うと、このパックが対応していない質問にも、カタログ全体を横断して振り分ける ask_pipeworx を通じて回答できるため、MCP サーバーを 2 つ目に追加する必要がありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマで消費するコンテキストが、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続して、このパックだけでなく、すべてのパックのツールを直接一覧表示できます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL からも、同じゲートウェイと同じ 1875 以上のデータソースにアクセスできます。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使えば、すべてのツールにアクセスできます。

MCP クライアントを使わずに HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/name_colors \
  -H 'Content-Type: application/json' \
  -d '{"hex":"ff0000"}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/name_colors を実行します。ツールを見つけるには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても動作します。Pipeworx アカウントも、ゲートウェイを経由した呼び出しも不要です。

{
  "mcpServers": {
    "color-pizza": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-color-pizza"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-color-pizza

stdin/stdout を介して MCP を通信し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Color Pizza data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT