{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_efmqe8pedead","handle":"workbuddy-mcp-comfyui","url":"https://wellknown.network/agents/workbuddy-mcp-comfyui","links":{"self":"https://wellknown.network/agents/workbuddy-mcp-comfyui/record.json","html":"https://wellknown.network/agents/workbuddy-mcp-comfyui","markdown":"https://wellknown.network/agents/workbuddy-mcp-comfyui/record.md","api":"https://wellknown.network/api/v1/agents/workbuddy-mcp-comfyui","status":"https://wellknown.network/api/v1/agents/workbuddy-mcp-comfyui/status","claim":"https://wellknown.network/agents/workbuddy-mcp-comfyui/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/workbuddy-mcp-comfyui/claim.json","badge":"https://wellknown.network/agents/workbuddy-mcp-comfyui/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/workbuddy-mcp-comfyui/history","tools":"https://wellknown.network/api/v1/agents/workbuddy-mcp-comfyui/tools"},"ard":{"identifier":"urn:air::server:workbuddy-mcp-comfyui","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"workbuddy-mcp-comfyui","summary":"WorkBuddy Connector MCP server for ComfyUI (stdio, auth_mode: token)","description":"# ComfyUI Connector（WorkBuddy）\n\n为腾讯 WorkBuddy 生态开发的 ComfyUI 连接器：MCP stdio + 用户自填 Token 模式\n（规范 06 / 06D 附录C），让 AI 通过自然语言运行 ComfyUI 工作流并取回生成的图片。\n\n## 目录结构\n\n```\ncomfyui/\n├── connector-meta.json   # 连接器元信息（type: mcp, auth_mode: token, minWorkbuddyVersion: 4.24.0）\n├── mcp.json              # MCP Server 连接配置（stdio，凭证经 env 注入）\n├── token-schema.json     # 用户自填 Token 表单（COMFY_URL + 可选 COMFY_TOKEN）\n├── comfy_mcp_server/     # MCP Server（Python，官方 mcp SDK FastMCP）\n│   ├── __init__.py\n│   ├── __main__.py       # python -m comfy_mcp_server 入口\n│   └── server.py         # 5 个 tool：list_checkpoints / list_samplers / run_workflow / get_status / get_image\n├── skills/\n│   └── SKILL.md          # Skill 文件（按 05 规范，教 AI 如何使用工具）\n├── icon.svg              # 连接器图标\n├── tests_smoke.py        # 冒烟测试（MCP stdio 客户端调工具，验证错误路径）\n├── pyproject.toml        # hatchling 打包（PyPI 包名 workbuddy-mcp-comfyui）\n└── README.md\n```\n\n依赖仅 `mcp`（v1，FastMCP）+ `httpx`（Python ≥ 3.10）。\n\n## 工具一览\n\n| Tool | 用途 |\n|---|---|\n| `list_checkpoints()` | 列出 checkpoint 模型（GET /object_info/CheckpointLoaderSimple） |\n| `list_samplers()` | 列出采样器与调度器（GET /object_info/KSampler） |\n| `run_workflow(workflow)` | 提交 API 格式工作流（POST /prompt），返回 prompt_id，只提交不等待 |\n| `get_status(prompt_id)` | 查询进度与输出（GET /history/{id}，未完成时对照 GET /queue） |\n| `get_image(filename, subfolder?, type?)` | 取回图片（GET /view），以 MCP ImageContent 返回 |\n\n标准链路：`list_checkpoints` 确认模型名 → `run_workflow` 提交 → 轮询\n`get_status` → 用 history outputs 里的 filename/subfolder/type 三元组调 `get_image`。\n\nCOMFY_TOKEN 仅在用户加了反向代理鉴权时才填；非空时 server 自动附加\n`Authorization: Bearer` 头，原生 ComfyUI 留空。httpx 超时 30s。\n\n## 本地测试\n\n```bash\ncd <项目目录>/connectors/comfyui\n\n# 1. 语法与 JSON 校验\npython3 -m py_compile comfy_mcp_server/*.py\nfor f in connector-meta.json mcp.json token-schema.json; do python3 -m json.tool \"$f\" > /dev/null && echo \"$f OK\"; done\n\n# 2. 起本地构建的 server 并调用工具（ComfyUI 未运行时验证错误路径）\n#    server 经 uvx --from 本地目录构建；客户端复用 home-assistant/.venv 里的 mcp 包\nexport UV_DEFAULT_INDEX=https://pypi.tuna.tsinghua.edu.cn/si…","publisher":{"name":"dangsys","url":null},"homepage":null,"repository":null,"version":"1.0.1","license":"MIT","protocols":["mcp"],"tags":["comfyui","image","generation","mcp","model-context-protocol","workbuddy"],"pricing":null,"endpoints":[{"url":"pypi:workbuddy-mcp-comfyui","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"code.generation","name":"Code Generation","confidence":1,"provenance":"declared"},{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"}],"categories":["code","security"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"workbuddy-mcp-comfyui","registry":"pypi","observedAt":"2026-10-23T00:27:15.582Z","publishedAt":"2026-09-08T17:46:17.431815Z","latestVersion":"1.0.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"workbuddy-mcp-comfyui","url":"https://pypi.org/project/workbuddy-mcp-comfyui/","firstSeenAt":"2026-09-10T16:22:27.888Z","fetchedAt":"2026-10-23T00:25:17.315Z","normalizedAt":"2026-10-23T00:25:17.315Z"}]},"firstSeenAt":"2026-09-10T16:22:27.888Z","updatedAt":"2026-10-23T00:27:15.582Z"}