Comfy-Guru

Name: Comfy-Guru
Availability: InStock
Author: endlessblink

Comfy-Guru is an mcp that connects Claude Desktop to your comfyui logs - to squash those errors (peacefully)

GitHub

GitHubスター

ユーザー評価

未評価

フォーク

イシュー

閲覧数

お気に入り

README

ComfyUI Log Debugger MCP Server (comfy-guru)

A Model Context Protocol (MCP) server that helps you debug ComfyUI by discovering and analyzing log files through Claude Desktop.

🚨 IMPORTANT: Tell Claude Where ComfyUI Is Located!

If ComfyUI isn't found automatically, just tell Claude in chat:

"My ComfyUI is at D:\MY PROJECTS\AI\STABLE DIFFUSION UI\ComfyUI"

Or configure it permanently - see Setup Guide

🚀 Quick Installation (30 seconds)

For Users:

Download comfy-guru.dxt (pre-built extension)
Open Claude Desktop and go to: Settings → Extensions
Click "Install Extension..."
Select the downloaded comfy-guru.dxt file
Done! No git clone, no Python setup needed!

Note: Don't double-click the .dxt file - install it through Claude Desktop's settings.

Important: After installation, fully restart Claude Desktop for the MCP extension to work properly.

For Developers:

To modify and rebuild the extension: python build_extension.py
This creates a new comfy-guru.dxt from source files

🎯 What It Does

Finds all your ComfyUI installations automatically
Discovers log files (including rotated logs, port-specific logs, debug logs)
Analyzes errors and categorizes them (CUDA, Node execution, Dependencies, etc.)
Monitors logs in real-time for new errors
Works everywhere - Windows, macOS, Linux, Docker

📋 Example Commands in Claude Desktop

Once installed, just ask Claude:

🔍 "Find all my ComfyUI log files"
🐛 "Check my ComfyUI logs for CUDA memory errors"
📊 "What errors happened in the last 30 minutes?"
👀 "Monitor my ComfyUI log for new errors"
🔧 "Analyze my ComfyUI workflow execution errors"

🛠️ Installation Options

Option 1: Easy Install (Recommended)

python easy_install.py

Option 2: Docker Install

# Windows
docker-install.bat

# Linux/Mac/WSL
./docker-install.sh

Option 3: Manual Install

See INSTALL.md for manual configuration of Claude Desktop.

⚙️ Configuration

The installer creates a .env file. Edit it to add custom ComfyUI paths:

Adding ComfyUI Paths Manually

Edit the .env file and add paths separated by commas:

# Your ComfyUI installations (comma-separated)
COMFYUI_PATHS=C:\ComfyUI,D:\MY PROJECTS\AI\ComfyUI,E:\Another\ComfyUI

# Search directories (only used if deep search is enabled)
COMFYUI_SEARCH_DIRS=C:\,D:\,E:\

# Deep search is OFF by default for performance
COMFYUI_DEEP_SEARCH=false

About Deep Search

Deep search is OFF by default because:

✅ Manual paths are found instantly (< 1 second)
❌ Deep search can take 30-100+ seconds
❌ Can cause permission errors on system folders

How to Use Deep Search Temporarily

Enable deep search to find all installations:
```
COMFYUI_DEEP_SEARCH=true
```
Run the discovery in Claude Desktop:
```
"Find all my ComfyUI installations"
```
Note the paths it finds

Add them to COMFYUI_PATHS manually:

COMFYUI_PATHS=path1,path2,path3,newly_found_path

Turn deep search OFF again:
```
COMFYUI_DEEP_SEARCH=false
```

This way you get the benefit of discovery without the performance penalty!

🧪 Testing

# Test the installation
python test_installation.py

Expected output:

✅ All imports successful
✅ Found X ComfyUI installations
✅ Found Y log files
✅ Error detection working

📁 Project Structure

comfy-guru/
├── src/                    # Core source files
│   ├── standalone_mcp_server.py
│   ├── debugger_server.py
│   ├── smart_log_discovery.py
│   └── error_patterns.json
├── docs/                   # Documentation
├── examples/              # Example files
├── scripts/               # Helper scripts
├── easy_install.py       # Easy installer
├── install.py           # Standard installer
├── test_installation.py # Test suite
└── requirements.txt     # Dependencies