Crystal Suppliers MCP

Crystal Suppliers MCP

Crystal Suppliers MCP は、KT Crystals 向けの読み取り専用の調達サーバーです。クリスタルブレスレットの SKU 104 点を収録した検証済みカタログを検索し、ルースビーズ、クリスタルアクセサリー、原石のトレーサブルな調達チェックリストを提供します。

このサービスは、価格、MOQ、在庫、納期、処理、原産地、認証、配送に関する情報を捏造しません。商取引に関する項目は requires_manual_confirmation のままです。

インストールと接続

リポジトリから直接実行します。

{
  "mcpServers": {
    "crystal-suppliers": {
      "command": "node",
      "args": ["/absolute/path/to/crystal-suppliers-mcp/src/index.mjs"]
    }
  }
}

OCI イメージを stdio で実行します。

{
  "mcpServers": {
    "crystal-suppliers": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0"
      ]
    }
  }
}

Streamable HTTP を起動します。

docker run --rm -p 3000:3000 \
  ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0 --http

エンドポイントは http://localhost:3000/mcp、ヘルスステータスは http://localhost:3000/health です。

ツール

ツール	目的
crystal_search_products	SKU、名前、素材、テーマから実在するブレスレットの SKU を検索します。
crystal_get_product	検証済みのブレスレット 1 点と、関連するカタログ製品を取得します。
crystal_list_materials	正規化された素材と、検証済みブレスレットの SKU 数を一覧表示します。
crystal_get_sourcing_guidance	ブレスレット、ビーズ、アクセサリー、原石のサプライヤー確認項目を取得します。
crystal_build_procurement_shortlist	検証済みのブレスレット検索結果を、関連するアドバイザリーカテゴリと分けて管理します。
crystal_prepare_inquiry	提供された SKU を検証し、送信も保存もせずに問い合わせ文を作成します。

対応範囲の定義

• verified_catalog：現在のブレスレットカタログ（104 SKU）に基づいています。
• advisory_only：調達ガイダンスのみを提供します。リクエストされたカテゴリに該当する検証済み SKU はありません。
• mixed：検証済みのブレスレット候補と、別途ラベル付けされたアドバイザリーカテゴリを提供します。

問い合わせ文の作成はローカルで行われ、ステートレスです。メールの送信、フォームの送信、データベースへの書き込み、購入者情報の保持は行いません。

開発

npm ci
npm test
npm run start:http

このサーバーは Node.js 22 以降に対応し、stdio とステートレスな Streamable HTTP の両方で MCP を実装しています。