Skip to main content
MCP (Model Context Protocol) is a model context protocol launched by Anthropic that allows AI models (such as Claude, GPT, etc.) to call external tools through standardized interfaces. With the Midjourney MCP Server provided by AceData Cloud, you can directly generate and edit AI images in AI clients like Claude Desktop, VS Code, Cursor, etc.

​
Feature Overview

The Midjourney MCP Server provides the following core functionalities:
  • Image Generation (Imagine) — Generate high-quality images from text prompts
  • Image Editing — Make local modifications to generated images
  • Image Transformation — Zoom in, zoom out, and pan existing images
  • Image Blending (Blend) — Merge multiple images into a new image
  • Reference Image Generation — Guide generation using reference images
  • Image Description (Describe) — Generate text descriptions based on images
  • Prompt Translation — Translate Chinese prompts into English
  • Seed Retrieval — Obtain the seed value of an image for reproduction
  • Video Generation — Generate dynamic videos based on images
  • Task Query — Monitor generation progress and obtain results

​
Prerequisites

Before use, you need to obtain an AceData Cloud API Token:
  1. Register or log in to the AceData Cloud platform
  2. Go to the Midjourney Imagine API page
  3. Click “Acquire” to get the API Token (first-time applicants receive free credits)

​
Installation Configuration

pip install mcp-midjourney

​
Method 2: Source Installation

git clone https://github.com/AceDataCloud/MCPMidjourney.git
cd MCPMidjourney
pip install -e .
Once installed, you can use the mcp-midjourney command to start the service.

​
Using in Claude Desktop

Edit the Claude Desktop configuration file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following configuration: 
{
  "mcpServers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Your API Token"
      }
    }
  }
}
If using uvx (no need to install packages in advance): 
{
  "mcpServers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Your API Token"
      }
    }
  }
}
After saving the configuration, restart Claude Desktop to use Midjourney-related tools in the conversation.

​
Using in VS Code / Cursor

Create a .vscode/mcp.json in the project root directory: 
{
  "servers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Your API Token"
      }
    }
  }
}
Or use uvx: 
{
  "servers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Your API Token"
      }
    }
  }
}

​
Available Tools List

Tool NameDescription
midjourney_imagineGenerate images from text prompts
midjourney_editEdit local areas of existing images
midjourney_transformZoom in, zoom out, and pan existing images
midjourney_blendMerge multiple images into one
midjourney_with_referenceGenerate images using reference images
midjourney_describeGenerate text descriptions based on images
midjourney_translateTranslate prompts into English
midjourney_get_seedRetrieve the seed value of an image
midjourney_generate_videoGenerate videos based on images
midjourney_extend_videoExtend existing videos
midjourney_get_taskQuery the status of a single task
midjourney_get_tasks_batchBatch query task statuses

​
Usage Examples

After configuration, you can directly call these functions in the AI client using natural language, for example:
  • “Help me generate a cyberpunk-style city night scene”
  • “Change the background of this image to the seaside”
  • “Blend these four images into one”
  • “Describe the content of this image”
  • “Make a video from this image”
  • “Zoom in on the second variant of this image”

​
More Information