comfyui-mcp 0.0.3

No project description provided

comfyui-mcp

A Model Context Protocol(MCP) server that exposes ComfyUI workflows as callable MCP tools. Built using FastMCP and comfyui-utils.

---

Installation

Contents of this package require Python 3.11 or higher.

pip install comfyui-mcp

---

Quick Start

mcpo --port 8000 --api-key "AwesomeKey" -- python3 -m comfyui_mcp.server

---

Architecture Overview

src/comfyui_mcp/

• __about__.py: # Version and license metadata
• argument_parser.py: CLI argument definitions using pydantic
• base_types.py: Shared type aliases
• function_utils.py: Dynamic function wrapper generation
• workflow_loader.py: Load workflows from disk or ComfyUI API
• workflow_utils.py: Workflow preparation and invocation
• server.py: FastMCP server entry point

How It Works

1. Workfllow discovery: fetch remote or local JSON.
2. Tool generation: parameters mapped into callable MCP tools.
3. Execution: runs workflow via ComfyUI API and returns image URLs as Markdown.
4. Batching: repeated invocations, seed randomization.

---

Development

pip setup -hatch
hatch test
hatch build
hatch run release

---

Contributing

1. Fork the repo on GitHub.
2. Make changes, add tests, and build
3. Run hatch test to ensure all passes
4. Submit a PR