@ldavis9000aws/swarmui-generator NPM

SwarmUI MCP Server

A Model Context Protocol (MCP) server for SwarmUI image generation with TypeScript.

This server provides an MCP interface for AI assistants to interact with the SwarmUI image generation API, allowing them to generate images, list available models and schedulers, and check system status.

🔥 Latest Update (v1.0.12)

Major Fix: Corrected MCP server implementation to comply with official TypeScript SDK patterns
Amazon Bedrock Compatibility: Fixed validation errors when using with Amazon Bedrock Claude models
Proper Protocol Implementation: Now follows the correct server.tool() parameter pattern
Enhanced Robustness: Improved error handling in accordance with MCP specifications

Features

Image Generation: Generate images from text prompts using stable diffusion models
Model Listing: List available stable diffusion models with metadata
Scheduler Listing: List available sampling methods/schedulers
System Status: Check the current state of the SwarmUI engine

Requirements

Node.js 16+
TypeScript 4.9+
A running SwarmUI instance with API access

Installation

Using npx (Recommended)

You can run the server directly using npx without installing it:

NPX_CONFIG_SWARMUI_API_URL=http://your-swarmui-server:port npx @ldavis9000aws/swarmui-generator

Or create a .env file with SWARMUI_API_URL and run:

npx @ldavis9000aws/swarmui-generator

Global Installation

You can also install the package globally:

npm install -g @ldavis9000aws/swarmui-generator

And then run it:

SWARMUI_API_URL=http://your-swarmui-server:port swarmui-generator

Usage

Running the Server

npm run start

The server will connect to the SwarmUI API and listen for MCP commands via stdio.

Development Mode

npm run dev

This runs the server using ts-node for development purposes.

Using with LibreChat

To use this MCP server with LibreChat, add the configuration to your librechat.yaml file:

mcpServers:
  swarmui:
    title: SwarmUI Image Generator
    description: Generate images using the SwarmUI API with stable diffusion models
    command: npx
    args:
      - "@ldavis9000aws/swarmui-generator"
    env:
      SWARMUI_API_URL: http://your-swarmui-server:port
    timeout: 120000 # Optional: timeout in milliseconds (2 minutes)

After adding this configuration: 1. Restart your LibreChat server 2. The SwarmUI Image Generator will appear in the model selection dropdown 3. Select Claude + SwarmUI to use this integration

You can use it with prompts like:

"Please generate an image of a cat in a space suit"
"Show me different models you can use for image generation"

API Reference

Tools

`generate_images`

Generates one or more images from a text prompt.

Parameters:

prompt (string, required): The main text prompt describing what to generate
negative_prompt (string, optional): Text describing what to avoid in the generation
width (integer, optional): Image width in pixels (256-1024)
height (integer, optional): Image height in pixels (256-1024)
guidance_scale (number, optional): How closely to follow the prompt (1-20)
num_inference_steps (integer, optional): Number of denoising steps (1-150)
num_images (integer, optional): Number of images to generate (1-4)
seed (integer, optional): Random seed for reproducible results
model_name (string, optional): Model to use for generation
scheduler (string, optional): Scheduler algorithm to use