comfy-ui

This MCP server provides a simple note storage system that integrates with a local comfyUI instance. It exposes a single tool named add-note that lets clients add a note by supplying a name and content, and a prompt summarize-notes that can generate a summary of all stored notes. Notes are accessible via a custom note:// URI scheme and each note has a name, description, and text/plain content type. To run locally, start the server using the uv workflow described in the quickstart, then connect with an MCP-compatible client or inspector to call add-note and to run summarize-notes. The summarize-notes prompt accepts an optional style argument (brief or detailed) to control the level of detail in the generated summary, and it combines all current notes into a single prompt for the model to summarize.

Prerequisites:

• Python 3.8+ (recommended)
• Git
• Optional: pipx for easier CLI management

Installation steps (development path):

1. Clone the repository: git clone https://github.com/slug-for-repo/comfy-ui-mcp-server.git cd comfy-ui-mcp-server

2. Install dependencies (local development):

   • If you have a Python environment ready, you can install in editable mode: python -m pip install -e .
   • Alternatively, install uv (MCP CLI) and any required tooling via your preferred method (e.g., pipx): pipx install uv

3. Run the server locally (as described in the Quickstart): uv --directory <path-to-repo> run comfy-ui-mcp-server

Production or published usage (optional):

• If you publish or preregister this server with a launcher, you can use the published configuration with uvx: uvx comfy-ui-mcp-server

Notes:

• Ensure your Python environment includes any dependencies the server requires. If the project uses a requirements.txt or pyproject.toml, install them before running the server.
• The README examples show using uv for development and uvx for published deployments; adapt according to your workflow.

Tips and notes:

• The server uses a note storage system with a note:// URI scheme; ensure clients interpret and display the note metadata properly.
• When using summarize-notes, you can pass a style argument (e.g., {"style": "detailed"}) to influence the verbosity of the summary.
• The add-note tool requires two strings: name and content. The server updates its internal state and notifies connected clients of resource changes.
• Development debugging is easier with the MCP Inspector. You can launch it via npm by running: npx @modelcontextprotocol/inspector uv --directory <path> run comfy-ui-mcp-server
• If you encounter path or directory issues on Windows vs. macOS, ensure your --directory argument correctly escapes backslashes on Windows (as shown in the README example).
• For production, consider using uvx with a stable installed package name and ensure your environment provides necessary permissions for networking and file access.