AgentSkillsCN

repo-b-mcp-comfy-bridge

为 <PRIVATE_REPO_B> 提供标准的 MCP 适配器与 Comfy 桥接操作。适用于启用 MCP、更新适配器配置、验证 shim.comfy 资源，或运行故障封闭的 Comfy 诊断时使用。这是 repo-b-local-comfy-orchestrator 的主要替代方案。

SKILL.md
--- frontmatter
name: repo-b-mcp-comfy-bridge
description: Canonical MCP adapter and Comfy bridge operations for <PRIVATE_REPO_B>. Use when enabling MCP, updating adapter config, validating shim.comfy resources, or running fail-closed Comfy diagnostics. This is the primary replacement for repo-b-local-comfy-orchestrator.

REPO_B Shim MCP Comfy Bridge

Use this skill as the canonical MCP + Comfy lane in <PRIVATE_REPO_B>.

repo-b-local-comfy-orchestrator is retained as a compatibility wrapper and should route here for new work.

Workflow

  1. •Enforce loopback-only MCP and fail-closed defaults.
  2. •Validate MCP runtime state via /api/mcp/status.
  3. •Apply /api/mcp/config changes only when configuration drift is confirmed.
  4. •Validate required Comfy resources (shim.comfy.status, shim.comfy.queue, shim.comfy.history).
  5. •Fail closed on stale status or schema contract violations.

Required Environment (PowerShell)

powershell
$env:SHIM_ENABLE_MCP = "1"
$env:SHIM_MCP_HOST = "127.0.0.1"
$env:SHIM_MCP_PORT = "9550"
$env:SHIM_MCP_ALLOW_LAN = "0"
$env:MX3_COMFYUI_ENABLED = "1"
$env:MX3_COMFYUI_BASE_URL = "http://127.0.0.1:8188"
$env:MX3_COMFYUI_TIMEOUT_S = "10"
$env:REPO_B_LOCAL_COMFY_ORCH_FAIL_CLOSED = "1"

Runtime/API Checks

bash
curl http://127.0.0.1:9000/api/mcp/status

Apply config:

bash
curl -X POST http://127.0.0.1:9000/api/mcp/config \
  -H "content-type: application/json" \
  -d '{"enabled":true,"persist":true,"apply_now":true}'

Resource Contract Checks

Validate these resource contracts before accepting diagnostics:

  1. •shim.comfy.status:
    • •enabled=true
    • •reachable=true
    • •empty last_error
    • •fresh checked_at
  2. •shim.comfy.queue:
    • •running_prompt_ids and pending_prompt_ids lists
    • •running_count and pending_count must match list lengths
  3. •shim.comfy.history:
    • •entries list
    • •count must match entries length

Advanced Diagnostics (Optional Legacy Tooling)

When deterministic artifact output is needed, use the legacy local orchestrator drop-ins from repo-b-local-comfy-orchestrator (tools/local_comfy_orchestrator.py, tools/local_comfy_validate.py):

bash
python tools/local_comfy_orchestrator.py \
  --task comfy-health-check \
  --json-out .codex/local_comfy/comfy-health-check.json \
  --repo-root .

Comfy Bridge Control Vars

  • •REPO_B_COMFYUI_ENABLED
  • •REPO_B_COMFYUI_BASE_URL
  • •REPO_B_COMFYUI_API_KEY
  • •REPO_B_COMFYUI_TIMEOUT_S

References

  • •references/mcp-comfy-checklist.md