soccerlover096/dreamstudio-mcp-server

DreamStudio MCP Server

MCP (Model Context Protocol) server for integrating Stability AI's DreamStudio API with Claude Desktop.

Features

• Text-to-Image Generation: Generate images from text prompts
• Image-to-Image Transformation: Transform existing images using text prompts
• Account Management: Check your DreamStudio balance and account info
• Multiple Engines: Support for SDXL, SDXL Turbo, and SD 1.6

Prerequisites

• Node.js 18+
• npm or yarn
• DreamStudio API key from Stability AI Platform
• Claude Desktop application

Installation

1. Clone the repository:

git clone https://github.com/soccerlover096/dreamstudio-mcp-server.git
cd dreamstudio-mcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Create a .env file with your API key:

STABILITY_API_KEY=sk-OL0wAdvQk1SNlvS49zm4VOx4Z2KrXmfGav010ybURLPw4P65

Configure Claude Desktop

Add the following to your Claude Desktop configuration file:

Windows: C:\Users\ha5he\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "dreamstudio": {
      "command": "node",
      "args": ["C:\\path\\to\\dreamstudio-mcp-server\\dist\\index.js"],
      "env": {
        "STABILITY_API_KEY": "sk-OL0wAdvQk1SNlvS49zm4VOx4Z2KrXmfGav010ybURLPw4P65"
      }
    }
  }
}

Replace C:\\path\\to\\dreamstudio-mcp-server with the actual path where you cloned this repository.

Available Tools

1. dreamstudio_text_to_image

Generate images from text descriptions.

Parameters:

• prompt (required): Text description of the image
• negative_prompt: Things to avoid in the image
• width: Image width (default: 1024)
• height: Image height (default: 1024)
• steps: Inference steps (default: 30)
• cfg_scale: Guidance scale (default: 7.0)
• samples: Number of images (default: 1)
• seed: Random seed for reproducibility
• engine: Engine to use (sdxl-turbo, sd-1.6, sdxl)

2. dreamstudio_image_to_image

Transform existing images using text prompts.

Parameters:

• init_image_path (required): Path to the initial image
• prompt (required): Text description for transformation
• negative_prompt: Things to avoid
• strength: Transformation strength 0.0-1.0 (default: 0.75)
• width: Output width
• height: Output height
• steps: Inference steps (default: 30)
• cfg_scale: Guidance scale (default: 7.0)
• seed: Random seed
• engine: Engine to use

3. dreamstudio_get_balance

Check your DreamStudio account balance and information.

Usage in Claude

After configuring, restart Claude Desktop. You can then use commands like:

"Generate an image of a beautiful sunset over mountains"

"Transform this image [provide path] to make it look like a watercolor painting"

"Check my DreamStudio balance"

Development

For development with hot reload:

npm run dev

License

MIT