chore: initial commit

2026-05-21 07:30:48 +02:00
commit 8826aefef2
6 changed files with 650 additions and 0 deletions
@@ -0,0 +1,78 @@
+# ComfyUI MCP
+
+**Type:** Docker / npm  
+**Group:** Image  
+**Port:** 8000
+
+## Description
+
+Connects to ComfyUI for image generation workflows and processing.
+
+## Deployment Options
+
+### Option 1: Inside MCP Gateway (Docker-in-Docker)
+
+Runs as a Docker container spawned by the MCP Gateway:
+
+**Configuration (pre-set):**
+- Image: `ghcr.io/richardi-ai/comfyui-mcp-server:latest`
+- Command: `--port 8000`
+- Connects to ComfyUI at `http://comfyui:8188`
+
+### Option 2: Local npm (for testing)
+
+```bash
+# Run locally
+npx -y @richardi-ai/comfyui-mcp-server --port 8000
+
+# Or with custom ComfyUI URL
+npx -y @richardi-ai/comfyui-mcp-server --port 8000 \
+  --base-url http://192.168.1.40:18002
+```
+
+## Environment Variables
+
+```bash
+COMFYUI_URL=http://comfyui:8188
+COMFYUI_WS_URL=ws://comfyui:8188
+```
+
+## Features
+
+- Generate images via ComfyUI workflows
+- Submit workflow JSON to ComfyUI
+- Check workflow status
+- Retrieve generated images
+- WebSocket support for real-time updates
+- Integrated with Claude.ai custom connector
+
+## ComfyUI Integration
+
+This MCP server connects to the existing ComfyUI instance:
+- **Base URL:** `http://comfyui:8188` (internal Docker network)
+- **Public URL:** `http://192.168.1.40:18002`
+
+## Usage in Claude.ai
+
+Available tools:
+- `comfyui_generate` - Generate images with ComfyUI
+- `comfyui_workflow` - Submit workflow JSON
+- `comfyui_status` - Check workflow status
+- `comfyui_history` - Get generation history
+
+## Testing
+
+```bash
+# Test locally (adjust URL if needed)
+COMFYUI_URL=http://192.168.1.40:18002 \
+npx -y @richardi-ai/comfyui-mcp-server --port 8000
+
+# Verify health
+curl http://localhost:8000/health
+```
+
+---
+
+**Documentation:** `/opt/stacks/ai/mcp-servers/comfyui/`  
+**Gateway UI:** `https://mcp.nuclide.systems/ui` (OAuth required)  
+**ComfyUI:** `http://192.168.1.40:18002`