[PR #16] Add comfy-local plugin (Comfy-Org/comfy-mcp) #15

New issue

Open

opened 2026-10-26 22:33:58 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-26 22:33:58 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/Comfy-Org/comfy-skills/pull/16
Author: @skishore23
Created: 8/7/2026
Status: 🔄 Open

Base: main ← Head: comfy-local-plugin

📝 Commits (2)

06bad9f Add comfy-local plugin for the local comfy-mcp server
eab4062 fix(comfy-local): address review — gallery vs live wording, spend claim, revalidate after editing, tested comfy-mcp version, MD040

📊 Changes

10 files changed (+224 additions, -5 deletions)

View changed files

📝 .claude-plugin/marketplace.json (+7 -1)
📝 README.md (+23 -4)
➕ claude-code-local/.claude-plugin/plugin.json (+16 -0)
➕ claude-code-local/commands/generate-image.md (+30 -0)
➕ claude-code-local/commands/generate-video.md (+54 -0)
➕ claude-code-local/commands/help.md (+36 -0)
➕ claude-code-local/commands/project-status.md (+9 -0)
➕ claude-code-local/commands/search-models.md (+11 -0)
➕ claude-code-local/commands/search-nodes.md (+20 -0)
➕ claude-code-local/commands/search-templates.md (+18 -0)

📄 Description

Summary

Adds a comfy-local Claude Code plugin (claude-code-local/) for Comfy-Org/comfy-mcp, the stdio MCP server that wraps comfy-cli against the user's own ComfyUI install. Mirrors the existing comfy-cloud plugin's structure: .claude-plugin/plugin.json registering uvx comfy-mcp, plus commands/.
Commands: generate-image, generate-video (dual-route OSS-vs-partner pattern plus the MiniMax H3 model-notes block, read from the h3-knowledge-and-dual-route branch and adapted to the local tool names), search-templates, search-models, search-nodes (the grouped nodes tool), project-status (COMFY_PROJECT anchoring), help.
Registers comfy-local in .claude-plugin/marketplace.json alongside comfy-cloud, and adds a matching install section + commands table to the README.

Context

The local server had no skills story: the only commands in this repo target the cloud server's tool names, and there was nothing pointing an agent at comfy-mcp's local-first surface (server_info, generate_image, run_workflow, the grouped job/download/nodes tools, partner_generate/emit_partner_workflow, validate_workflow, etc). This plugin gives it one, matching the cloud plugin's shape so both can be installed side by side under separate command namespaces.

Commands are grounded against comfy-mcp's feat/tool-consolidation branch (which merges feat/project-anchoring), currently the accurate 39-tool surface — main is a few commits behind that unmerged work. Per the repo's authoring rule, commands steer the approach (route by intent, validate before running, only set confirm_spend on actual user agreement) and defer specifics (model/template/node names) to the tools themselves.

PyPI publish of comfy-mcp is a soft dependency for the uvx comfy-mcp registration in plugin.json — publishing is in flight, so the plugin will resolve once that lands.

Test plan

claude plugin validate ./claude-code — passes
claude plugin validate ./claude-code-local — passes
.claude-plugin/marketplace.json and claude-code-local/.claude-plugin/plugin.json are valid JSON
comfy-cloud's commands and the h3-knowledge-and-dual-route branch were read from, not modified
End-to-end /plugin install comfy-local@comfy-skills + a live uvx comfy-mcp session, blocked on the PyPI publish landing

🤖 Generated with Claude Code

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/Comfy-Org/comfy-skills/pull/16 **Author:** [@skishore23](https://github.com/skishore23) **Created:** 8/7/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `comfy-local-plugin` --- ### 📝 Commits (2) - [`06bad9f`](https://github.com/Comfy-Org/comfy-skills/commit/06bad9f8e8876111c311ad5fcf3a947f382542b2) Add comfy-local plugin for the local comfy-mcp server - [`eab4062`](https://github.com/Comfy-Org/comfy-skills/commit/eab40629ae9f2e5e377c76374c4e55c43199b87f) fix(comfy-local): address review — gallery vs live wording, spend claim, revalidate after editing, tested comfy-mcp version, MD040 ### 📊 Changes **10 files changed** (+224 additions, -5 deletions) <details> <summary>View changed files</summary> 📝 `.claude-plugin/marketplace.json` (+7 -1) 📝 `README.md` (+23 -4) ➕ `claude-code-local/.claude-plugin/plugin.json` (+16 -0) ➕ `claude-code-local/commands/generate-image.md` (+30 -0) ➕ `claude-code-local/commands/generate-video.md` (+54 -0) ➕ `claude-code-local/commands/help.md` (+36 -0) ➕ `claude-code-local/commands/project-status.md` (+9 -0) ➕ `claude-code-local/commands/search-models.md` (+11 -0) ➕ `claude-code-local/commands/search-nodes.md` (+20 -0) ➕ `claude-code-local/commands/search-templates.md` (+18 -0) </details> ### 📄 Description ## Summary - Adds a `comfy-local` Claude Code plugin (`claude-code-local/`) for `Comfy-Org/comfy-mcp`, the stdio MCP server that wraps `comfy-cli` against the user's own ComfyUI install. Mirrors the existing `comfy-cloud` plugin's structure: `.claude-plugin/plugin.json` registering `uvx comfy-mcp`, plus `commands/`. - Commands: `generate-image`, `generate-video` (dual-route OSS-vs-partner pattern plus the MiniMax H3 model-notes block, read from the `h3-knowledge-and-dual-route` branch and adapted to the local tool names), `search-templates`, `search-models`, `search-nodes` (the grouped `nodes` tool), `project-status` (`COMFY_PROJECT` anchoring), `help`. - Registers `comfy-local` in `.claude-plugin/marketplace.json` alongside `comfy-cloud`, and adds a matching install section + commands table to the README. ## Context The local server had no skills story: the only commands in this repo target the cloud server's tool names, and there was nothing pointing an agent at `comfy-mcp`'s local-first surface (`server_info`, `generate_image`, `run_workflow`, the grouped `job`/`download`/`nodes` tools, `partner_generate`/`emit_partner_workflow`, `validate_workflow`, etc). This plugin gives it one, matching the cloud plugin's shape so both can be installed side by side under separate command namespaces. Commands are grounded against `comfy-mcp`'s `feat/tool-consolidation` branch (which merges `feat/project-anchoring`), currently the accurate 39-tool surface — `main` is a few commits behind that unmerged work. Per the repo's authoring rule, commands steer the approach (route by intent, validate before running, only set `confirm_spend` on actual user agreement) and defer specifics (model/template/node names) to the tools themselves. PyPI publish of `comfy-mcp` is a soft dependency for the `uvx comfy-mcp` registration in `plugin.json` — publishing is in flight, so the plugin will resolve once that lands. ## Test plan - [x] `claude plugin validate ./claude-code` — passes - [x] `claude plugin validate ./claude-code-local` — passes - [x] `.claude-plugin/marketplace.json` and `claude-code-local/.claude-plugin/plugin.json` are valid JSON - [x] `comfy-cloud`'s commands and the `h3-knowledge-and-dual-route` branch were read from, not modified - [ ] End-to-end `/plugin install comfy-local@comfy-skills` + a live `uvx comfy-mcp` session, blocked on the PyPI publish landing 🤖 Generated with [Claude Code](https://claude.com/claude-code) --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi added the

pull-request

label

2026-10-26 22:33:58 +00:00

bsakaguchi referenced this issue

2026-10-26 22:34:00 +00:00

[PR #17] [MERGED] fix(generate-video): correct MiniMax H3 routing facts #16