@fre4x/comfyui 1.0.65 → 1.1.0-beta.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +43 -5
- package/dist/index.js +1020 -112
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -11,6 +11,10 @@ An MCP server to interact with ComfyUI remotely. Probe server state, inspect nod
|
|
|
11
11
|
- `comfyui_workflow_run`: Run a stored workflow with optional overrides.
|
|
12
12
|
- `comfyui_wait_for_workflow`: Wait for workflow completion with a timeout.
|
|
13
13
|
|
|
14
|
+
`comfyui_discover_workflows` filters out non-workflow JSON files and distinguishes
|
|
15
|
+
between API workflows and Web UI graphs whose conversion was validated against the
|
|
16
|
+
live node schema.
|
|
17
|
+
|
|
14
18
|
**Do not assume `structuredContent` is what the model actually sees.** Many MCP clients
|
|
15
19
|
surface `content.text` to the model first and treat `structuredContent` as secondary
|
|
16
20
|
machine-readable metadata. Every actionable detail that an agent needs for its next step
|
|
@@ -60,6 +64,9 @@ If you want a single call that submits and waits, pass `await: true` with a
|
|
|
60
64
|
`timeout` value in seconds to `comfyui_workflow_run`. For lower-level control,
|
|
61
65
|
use `comfyui_wait_for_workflow` with `prompt_id` and `timeout`.
|
|
62
66
|
|
|
67
|
+
`comfyui_workflow_run` accepts either a stored workflow reference
|
|
68
|
+
(`workflow_id` / `workflow_file_path`) or an inline `workflow` JSON object.
|
|
69
|
+
|
|
63
70
|
## Stored Workflow Reuse
|
|
64
71
|
|
|
65
72
|
The stored-workflow tools let you avoid re-sending large API JSON blobs and give
|
|
@@ -71,20 +78,32 @@ agents a stable local edit loop.
|
|
|
71
78
|
4. Reuse it with `comfyui_workflow_run`
|
|
72
79
|
|
|
73
80
|
`comfyui_workflow_run` and `comfyui_save_workflow` both accept dot-notation
|
|
74
|
-
overrides in
|
|
81
|
+
overrides in canonical `node.inputs.field` form, plus shorter aliases like
|
|
82
|
+
`node.seed`, `node.text`, `node.positive_prompt`, and, for Web UI workflows,
|
|
83
|
+
`node.widgets[index]`.
|
|
75
84
|
|
|
76
85
|
```json
|
|
77
86
|
{
|
|
78
87
|
"workflow_id": "pony-portrait-v1",
|
|
79
88
|
"overrides": {
|
|
80
|
-
"2.
|
|
81
|
-
"6.
|
|
89
|
+
"2.seed": 67890,
|
|
90
|
+
"6.positive_prompt": "cinematic dragon portrait"
|
|
82
91
|
},
|
|
83
92
|
"await": true,
|
|
84
93
|
"timeout": 90
|
|
85
94
|
}
|
|
86
95
|
```
|
|
87
96
|
|
|
97
|
+
If your client serializes nested arguments first, `overrides` may also be sent
|
|
98
|
+
as a JSON string:
|
|
99
|
+
|
|
100
|
+
```json
|
|
101
|
+
{
|
|
102
|
+
"workflow_id": "pony-portrait-v1",
|
|
103
|
+
"overrides": "{\"2.seed\":67890,\"6.positive_prompt\":\"cinematic dragon portrait\"}"
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
88
107
|
To inspect editable inputs and semantic hints for agent editing:
|
|
89
108
|
|
|
90
109
|
```json
|
|
@@ -94,14 +113,33 @@ To inspect editable inputs and semantic hints for agent editing:
|
|
|
94
113
|
}
|
|
95
114
|
```
|
|
96
115
|
|
|
116
|
+
`comfyui_get_workflow` and `comfyui_save_workflow` both return:
|
|
117
|
+
|
|
118
|
+
- `high_signal_inputs`: the most useful prompt/model/sampler controls first
|
|
119
|
+
- `input_groups`: grouped counts for prompts, models, sampling, output, etc.
|
|
120
|
+
- combo-backed inputs include `options_count`, `options_preview`, and `options_truncated`
|
|
121
|
+
- `override_examples`: copy-ready payloads using the preferred override aliases
|
|
122
|
+
|
|
123
|
+
These appear in both `content.text` and `structuredContent` so agents can steer
|
|
124
|
+
complex workflows without having to scan every literal widget first.
|
|
125
|
+
|
|
126
|
+
When `comfyui_wait_for_workflow` times out, the error now includes a queue
|
|
127
|
+
snapshot in both `content.text` and `structuredContent` to show whether the
|
|
128
|
+
prompt is still pending or has disappeared from the server queue.
|
|
129
|
+
|
|
130
|
+
`comfyui_workflow_run` also performs a preflight pass against the live
|
|
131
|
+
`/object_info` schema before submission so invalid combo-backed values such as
|
|
132
|
+
missing checkpoints, LoRAs, VAEs, or input filenames fail fast without entering
|
|
133
|
+
the ComfyUI queue.
|
|
134
|
+
|
|
97
135
|
To save a new or edited workflow locally:
|
|
98
136
|
|
|
99
137
|
```json
|
|
100
138
|
{
|
|
101
139
|
"workflow_file_path": "pony-portrait-v1.json",
|
|
102
140
|
"overrides": {
|
|
103
|
-
"6.
|
|
104
|
-
"7.
|
|
141
|
+
"6.text": "studio lighting, ultra detailed",
|
|
142
|
+
"7.filename_prefix": "pony-portrait-agent"
|
|
105
143
|
},
|
|
106
144
|
"output_file_name": "pony-portrait-agent.json",
|
|
107
145
|
"overwrite": true
|