MCP Midjourney MCP Server

MCP Midjourney

A Model Context Protocol (MCP) server for AI image and video generation using Midjourney through the AceDataCloud API.

Generate AI images, videos, and manage creative projects directly from Claude, VS Code, or any MCP-compatible client.

Features

• Image Generation - Create AI-generated images from text prompts
• Image Transformation - Upscale, create variations, zoom, and pan images
• Image Blending - Combine multiple images into creative fusions
• Reference-Based Generation - Use existing images as inspiration
• Image Description - Get AI descriptions of images (reverse prompt)
• Image Editing - Edit images with text prompts and masks
• Video Generation - Create videos from text and reference images
• Video Extension - Extend existing videos to make them longer
• Translation - Translate Chinese prompts to English
• Task Tracking - Monitor generation progress and retrieve results

Quick Start

1. Get API Token

Get your API token from AceDataCloud Platform:

1. Sign up or log in
2. Navigate to Midjourney Imagine API
3. Click "Acquire" to get your token

2. Install

# Clone the repository
git clone https://github.com/AceDataCloud/mcp-midjourney.git
cd mcp-midjourney

# Install with pip
pip install -e .

# Or with uv (recommended)
uv pip install -e .

3. Configure

# Copy example environment file
cp .env.example .env

# Edit with your API token
echo "ACEDATACLOUD_API_TOKEN=your_token_here" > .env

4. Run

# Run the server
mcp-midjourney

# Or with Python directly
python main.py

Claude Desktop Integration

Add to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Or if using uv:

{
  "mcpServers": {
    "midjourney": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-midjourney", "mcp-midjourney"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Remote HTTP Mode (Hosted)

AceDataCloud hosts a managed MCP server that you can connect to directly — no local installation required.

Endpoint: https://midjourney.mcp.acedata.cloud/mcp

All requests require a Bearer token in the Authorization header. Get your token from AceDataCloud Platform.

Claude Desktop (Remote)

{
  "mcpServers": {
    "midjourney": {
      "type": "streamable-http",
      "url": "https://midjourney.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer your_api_token_here"
      }
    }
  }
}

Cursor / VS Code

In your MCP client settings, add:

• Type: streamable-http
• URL: https://midjourney.mcp.acedata.cloud/mcp
• Headers: Authorization: Bearer your_api_token_here

cURL Test

# Health check (no auth required)
curl https://midjourney.mcp.acedata.cloud/health

# MCP initialize (requires Bearer token)
curl -X POST https://midjourney.mcp.acedata.cloud/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer your_api_token_here" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

Self-Hosting with Docker

docker pull ghcr.io/acedatacloud/mcp-midjourney:latest
docker run -p 8000:8000 ghcr.io/acedatacloud/mcp-midjourney:latest

Clients connect with their own Bearer token — the server extracts the token from each request's Authorization header and uses it for upstream API calls.

Available Tools

Image Generation

Image Editing