mcpField
C
comfyui-inventory

comfyui-inventory

github.com/mckruzクリエイティブ・メディア92567 回インストール32 週間前に更新
リポジトリ

comfyui-inventory について

インストール済みの ComfyUI を調査し、ワークフローを検証するスキルです。稼働中はシステム、ノード、モデル情報を取得し、オフライン時はファイルをスキャンします。

主な機能

  1. 01システムと GPU 情報の取得
  2. 02インストール済みノードとモデルの検出
  3. 03オフラインでのインストールファイルの走査
  4. 04ワークフロー検証用の情報キャッシュ
  5. 05ノードとモデル参照の検証

活用シーン

  1. 01ワークフロー作成前の利用可能モデル確認
  2. 02ワークフローで不足しているノードパッケージの特定
  3. 03ComfyUI オフライン時のインストール内容確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mckruz/comfyui-expert --skill comfyui-inventory

インストール後、Claude Code で/comfyui-inventoryを入力して読み込まれたか確認します。

詳細

ComfyUI インベントリスキル

ユーザーの ComfyUI インスタンスにインストールされているものを検出し、ワークフロー検証用に結果をキャッシュします。

目的

ワークフローを生成する前に、必ずインベントリを確認する必要があります。これにより、次の問題を防げます。

  • ダウンロードされていないモデルを参照する
  • インストールされていないノードを使用する
  • VRAM の上限を超える

2 つの検出モード

オンラインモード（ComfyUI API が稼働中）

稼働中のサーバーに問い合わせ、信頼できる情報を取得します。

1. システム情報：

curl http://127.0.0.1:8188/system_stats

取得する情報：GPU 名、VRAM の合計、空き VRAM、ComfyUI のバージョン。

2. インストール済みノード：

curl http://127.0.0.1:8188/object_info

入出力の仕様を含む、登録済みのすべてのノードクラスを返します。

3. インストール済みモデル（タイプ別）：

curl http://127.0.0.1:8188/models/checkpoints
curl http://127.0.0.1:8188/models/loras
curl http://127.0.0.1:8188/models/vae
curl http://127.0.0.1:8188/models/controlnet
curl http://127.0.0.1:8188/models/clip
curl http://127.0.0.1:8188/models/clip_vision
curl http://127.0.0.1:8188/models/upscale_models
curl http://127.0.0.1:8188/models/diffusion_models
オフラインモード（ディレクトリのスキャン）

ComfyUI が起動していない場合は、ファイルシステムを直接スキャンします。

必要条件：ComfyUI のインストールパス（例：C:\ComfyUI）

スキャンするディレクトリ：

{ComfyUI}/models/checkpoints/    → .safetensors, .ckpt
{ComfyUI}/models/loras/          → .safetensors
{ComfyUI}/models/vae/            → .safetensors, .pt
{ComfyUI}/models/controlnet/     → .safetensors, .pth
{ComfyUI}/models/clip/           → .safetensors
{ComfyUI}/models/clip_vision/    → .safetensors
{ComfyUI}/models/upscale_models/ → .pth, .safetensors
{ComfyUI}/models/diffusion_models/ → .safetensors
{ComfyUI}/models/ipadapter/      → .safetensors, .bin
{ComfyUI}/models/instantid/      → .bin
{ComfyUI}/models/insightface/    → .onnx + folders
{ComfyUI}/models/facerestore_models/ → .pth
{ComfyUI}/models/ultralytics/bbox/ → .pt
{ComfyUI}/custom_nodes/          → folder names = node packages

カスタムノードの検出：custom_nodes/ 内のディレクトリを一覧表示します。各ディレクトリ名がノードパッケージに対応します（例：ComfyUI_IPAdapter_plus、ComfyUI-Impact-Pack）。

キャッシュ形式

結果を state/inventory.json に保存します。

{
  "last_updated": "2026-02-06T12:00:00Z",
  "mode": "online",
  "comfyui_version": "0.3.10",
  "system": {
    "gpu": "NVIDIA RTX 5090",
    "vram_total_gb": 32,
    "vram_free_gb": 28
  },
  "models": {
    "checkpoints": ["flux1-dev.safetensors", "RealVisXL_V5.0.safetensors"],
    "loras": ["sage_character.safetensors"],
    "vae": ["ae.safetensors", "wan_2.1_vae.safetensors"],
    "controlnet": ["instantid_controlnet.safetensors"],
    "clip": ["t5xxl_fp16.safetensors", "clip_l.safetensors"],
    "clip_vision": ["CLIP-ViT-H-14-laion2B-s32B-b79K.safetensors"],
    "upscale_models": ["4x-UltraSharp.pth"],
    "diffusion_models": ["wan2.1_i2v_720p_14b_bf16.safetensors"],
    "ipadapter": ["ip-adapter-faceid-plusv2_sd15.bin"],
    "instantid": ["ip-adapter.bin"],
    "insightface": ["inswapper_128.onnx"],
    "facerestore": ["codeformer.pth"],
    "detection": ["face_yolov8m.pt"]
  },
  "custom_nodes": [
    "ComfyUI-Manager",
    "ComfyUI_IPAdapter_plus",
    "ComfyUI_InstantID",
    "ComfyUI-Impact-Pack",
    "ComfyUI-AnimateDiff-Evolved",
    "ComfyUI-VideoHelperSuite"
  ]
}

ワークフローの検証

ワークフロー JSON を指定し、インベントリと照合して検証します。

For each node:
  1. Check class_type against known node classes
  2. If missing: identify which custom_node package provides it
  3. Suggest install: "Install via ComfyUI-Manager: {package_name}"

For each model reference:
  1. Check filename against inventory models of that type
  2. If missing: look up in references/models.md for download link
  3. Report: "Missing: {filename} - Download from {url} -> {path}"

よくあるノードとパッケージの対応表

ノードクラスパッケージ
ApplyInstantIDComfyUI_InstantID
IPAdapterUnifiedLoaderComfyUI_IPAdapter_plus
FaceDetailerComfyUI-Impact-Pack
ReactorFaceSwapComfyUI-ReActor
AnimateDiffLoaderWithContextComfyUI-AnimateDiff-Evolved
VideoHelper*ComfyUI-VideoHelperSuite
ControlNetApply*comfyui_controlnet_aux
UltimateSDUpscaleComfyUI_UltimateSDUpscale
VHS_*ComfyUI-VideoHelperSuite
RIFE*ComfyUI-Frame-Interpolation

キャッシュの有効期間

  • アクティブなセッション中、キャッシュは1 時間有効です
  • ユーザーが新しいモデルやノードをインストールしたら、キャッシュを無効化します
  • 強制更新：scan-inventory.ps1 または API への再問い合わせ

統合

  • ワークフロー生成前に comfyui-workflow-builder から呼び出されます
  • モデル選択のため、comfyui-character-gen から（エージェントラッパー経由で）呼び出されます
  • モデルが見つからないエラーの診断時に comfyui-troubleshooter から呼び出されます
  • すべてのスキルが参照できるよう、結果は state/inventory.json に保存されます

コメント

Markdown 対応