Connects Claude and other MCP clients to Midjourney's image and video generation through the AceDataCloud API. Exposes 15 tools covering the full creative workflow: imagine for text-to-image, transform for upscaling and variations, blend for combining images, describe for reverse prompting, and edit for masked modifications. Also handles video generation and extension, reference-based creation, seed extraction, and task tracking. Hosted endpoint means no local setup, just drop in your AceDataCloud token and start generating. Useful when you want AI image workflows directly in your chat or editor without switching to Discord or the Midjourney web interface.
Public tool metadata for what this MCP can expose to an agent.
midjourney_describeGet AI-generated descriptions of an image. This analyzes an image and returns 4 alternative text descriptions that could be used as prompts to recreate similar images with Midjourney. Use this when: - You want to understand what prompts might create a similar image - You want...1 paramsGet AI-generated descriptions of an image. This analyzes an image and returns 4 alternative text descriptions that could be used as prompts to recreate similar images with Midjourney. Use this when: - You want to understand what prompts might create a similar image - You want...
image_urlstringmidjourney_editEdit an existing image using Midjourney. This allows you to modify an existing image based on a text prompt, optionally using a mask to specify which regions to edit. Use this when: - You want to modify an existing image with AI - You want to add or change elements in an image...6 paramsEdit an existing image using Midjourney. This allows you to modify an existing image based on a text prompt, optionally using a mask to specify which regions to edit. Use this when: - You want to modify an existing image with AI - You want to add or change elements in an image...
maskstringmodestringfast · relax · turbodefault: fastpromptstringimage_urlstringcallback_urlvaluesplit_imagesbooleanmidjourney_imagineGenerate AI images from a text prompt using Midjourney. This is the primary way to create images - describe what you want and Midjourney will generate a 2x2 grid of 4 image variations. Use this when: - You want to create new images from a text description - You have a creative...11 paramsGenerate AI images from a text prompt using Midjourney. This is the primary way to create images - describe what you want and Midjourney will generate a 2x2 grid of 4 image variations. Use this when: - You want to create new images from a text description - You have a creative...
hdbooleanmodestringfast · relax · turbodefault: fastpromptstringqualityvaluetimeoutvalueversionvaluemoodboardbooleantranslationbooleancallback_urlvaluesplit_imagesbooleanstyle_referencebooleanmidjourney_transformTransform an existing Midjourney image with various operations. This allows you to upscale, create variations, zoom, or pan existing images generated by Midjourney. Use this when: - You want to upscale one of the 4 images from a generation - You want to create variations of a...5 paramsTransform an existing Midjourney image with various operations. This allows you to upscale, create variations, zoom, or pan existing images generated by Midjourney. Use this when: - You want to upscale one of the 4 images from a generation - You want to create variations of a...
maskstringmodestringfast · relax · turbodefault: fastactionstringgenerate · upscale1 · upscale2 · upscale3 · upscale4 · upscale_2xpromptstringimage_idstringmidjourney_blendBlend multiple images together using Midjourney. This allows you to combine 2-5 images into a new creative fusion. Use this when: - You want to merge elements from multiple images - You want to create composite images - You want to blend styles or subjects together Example: -...3 paramsBlend multiple images together using Midjourney. This allows you to combine 2-5 images into a new creative fusion. Use this when: - You want to merge elements from multiple images - You want to create composite images - You want to blend styles or subjects together Example: -...
modestringfast · relax · turbodefault: fastpromptstringimage_urlsarraymidjourney_with_referenceGenerate images using a reference image as inspiration. This allows you to use an existing image as a starting point and modify it based on your prompt description. Use this when: - You want to reimagine an existing image with modifications - You want to change the style of an...3 paramsGenerate images using a reference image as inspiration. This allows you to use an existing image as a starting point and modify it based on your prompt description. Use this when: - You want to reimagine an existing image with modifications - You want to change the style of an...
modestringfast · relax · turbodefault: fastpromptstringreference_image_urlstringmidjourney_list_actionsList all available Midjourney API actions and corresponding tools. Reference guide for what each action does and which tool to use. Helpful for understanding the full capabilities of the Midjourney MCP. Returns: Categorized list of all actions and their corresponding tools.List all available Midjourney API actions and corresponding tools. Reference guide for what each action does and which tool to use. Helpful for understanding the full capabilities of the Midjourney MCP. Returns: Categorized list of all actions and their corresponding tools.
No parameter schema in public metadata yet.
midjourney_get_prompt_guideGet guidance on writing effective prompts for Midjourney. Shows how to structure prompts and use parameters for best results. Following this guide helps Midjourney understand your creative vision. Returns: Complete guide with prompt structure, parameters, and examples.Get guidance on writing effective prompts for Midjourney. Shows how to structure prompts and use parameters for best results. Following this guide helps Midjourney understand your creative vision. Returns: Complete guide with prompt structure, parameters, and examples.
No parameter schema in public metadata yet.
midjourney_list_transform_actionsList all available transformation actions for Midjourney images. Reference guide for transform actions used with midjourney_transform tool. Returns: Detailed list of all transformation actions and when to use them.List all available transformation actions for Midjourney images. Reference guide for transform actions used with midjourney_transform tool. Returns: Detailed list of all transformation actions and when to use them.
No parameter schema in public metadata yet.
midjourney_get_seedGet the seed value of a previously generated Midjourney image. The seed is a numeric value that controls the randomness of generation. Using the same seed with the same prompt will produce similar results, which is useful for reproducible generation or fine-tuning prompts. Use...1 paramsGet the seed value of a previously generated Midjourney image. The seed is a numeric value that controls the randomness of generation. Using the same seed with the same prompt will produce similar results, which is useful for reproducible generation or fine-tuning prompts. Use...
image_idstringmidjourney_get_taskQuery the status and result of a Midjourney generation task. Use this to check if a generation is complete and retrieve the resulting image/video URLs and metadata. Use this when: - You want to check if a generation has completed - You need to retrieve URLs from a previous gen...1 paramsQuery the status and result of a Midjourney generation task. Use this to check if a generation is complete and retrieve the resulting image/video URLs and metadata. Use this when: - You want to check if a generation has completed - You need to retrieve URLs from a previous gen...
task_idstringmidjourney_get_tasks_batchQuery multiple Midjourney generation tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling midjourney_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of s...1 paramsQuery multiple Midjourney generation tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling midjourney_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of s...
task_idsarraymidjourney_translateTranslate Chinese text to English for use as Midjourney prompts. Midjourney works best with English prompts. This tool helps translate Chinese descriptions to English, optimized for image generation. Use this when: - You have a Chinese description that needs translation - You...1 paramsTranslate Chinese text to English for use as Midjourney prompts. Midjourney works best with English prompts. This tool helps translate Chinese descriptions to English, optimized for image generation. Use this when: - You have a Chinese description that needs translation - You...
contentstringmidjourney_generate_videoGenerate a video from text prompt and reference image using Midjourney. This creates an AI-generated video based on your description and a starting frame image. You can optionally specify an ending frame for more control. Use this when: - You want to animate a still image - Yo...7 paramsGenerate a video from text prompt and reference image using Midjourney. This creates an AI-generated video based on your description and a starting frame image. You can optionally specify an ending frame for more control. Use this when: - You want to animate a still image - Yo...
loopbooleanmodestringfast · relax · turbodefault: fastpromptstringimage_urlstringresolutionstring480p · 720pdefault: 720pcallback_urlvalueend_image_urlstringmidjourney_extend_videoExtend an existing Midjourney video to make it longer. This allows you to continue a previously generated video by adding more frames based on your prompt description. Use this when: - You want to make a video longer - You want to continue the story or motion from an existing...6 paramsExtend an existing Midjourney video to make it longer. This allows you to continue a previously generated video by adding more frames based on your prompt description. Use this when: - You want to make a video longer - You want to continue the story or motion from an existing...
modestringfast · relax · turbodefault: fastpromptstringvideo_idstringvideo_indexintegercallback_urlvalueend_image_urlstringA 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.
| Tool | Description |
|---|---|
midjourney_imagine | Generate AI images from a text prompt using Midjourney. |
midjourney_transform | Transform an existing Midjourney image with various operations. |
midjourney_blend | Blend multiple images together using Midjourney. |
midjourney_with_reference | Generate images using a reference image as inspiration. |
midjourney_edit | Edit an existing image using Midjourney. |
midjourney_describe | Get AI-generated descriptions of an image. |
midjourney_generate_video | Generate a video from text prompt and reference image using Midjourney. |
midjourney_extend_video | Extend an existing Midjourney video to make it longer. |
midjourney_translate | Translate Chinese text to English for use as Midjourney prompts. |
midjourney_get_seed | Get the seed value of a previously generated Midjourney image. |
midjourney_get_task | Query the status and result of a Midjourney generation task. |
midjourney_get_tasks_batch | Query multiple Midjourney generation tasks at once. |
midjourney_list_actions | List all available Midjourney API actions and corresponding tools. |
midjourney_get_prompt_guide | Get guidance on writing effective prompts for Midjourney. |
midjourney_list_transform_actions | List all available transformation actions for Midjourney images. |
AceDataCloud hosts a managed MCP server — no local installation required.
Endpoint: https://midjourney.mcp.acedata.cloud/mcp
All requests require a Bearer token. Use the API token from Step 1.
Connect directly on Claude.ai with OAuth — no API token needed:
https://midjourney.mcp.acedata.cloud/mcpAdd to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"midjourney": {
"type": "streamable-http",
"url": "https://midjourney.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to your MCP config (.cursor/mcp.json or .windsurf/mcp.json):
{
"mcpServers": {
"midjourney": {
"type": "streamable-http",
"url": "https://midjourney.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to your VS Code MCP config (.vscode/mcp.json):
{
"servers": {
"midjourney": {
"type": "streamable-http",
"url": "https://midjourney.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Or install the Ace Data Cloud MCP extension for VS Code, which registers the hosted MCP servers with one-click setup.
{
"mcpServers": {
"midjourney": {
"url": "https://midjourney.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Claude Code supports MCP servers natively:
claude mcp add midjourney --transport http https://midjourney.mcp.acedata.cloud/mcp \
-h "Authorization: Bearer YOUR_API_TOKEN"
Or add to your project's .mcp.json:
{
"mcpServers": {
"midjourney": {
"type": "streamable-http",
"url": "https://midjourney.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to Cline's MCP settings (.cline/mcp_settings.json):
{
"mcpServers": {
"midjourney": {
"type": "streamable-http",
"url": "https://midjourney.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to your MCP configuration:
{
"mcpServers": {
"midjourney": {
"type": "streamable-http",
"url": "https://midjourney.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to Roo Code MCP settings:
{
"mcpServers": {
"midjourney": {
"type": "streamable-http",
"url": "https://midjourney.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to .continue/config.yaml:
mcpServers:
- name: midjourney
type: streamable-http
url: https://midjourney.mcp.acedata.cloud/mcp
headers:
Authorization: "Bearer YOUR_API_TOKEN"
Add to Zed's settings (~/.config/zed/settings.json):
{
"language_models": {
"mcp_servers": {
"midjourney": {
"url": "https://midjourney.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
# Health check (no auth required)
curl https://midjourney.mcp.acedata.cloud/health
# MCP initialize
curl -X POST https://midjourney.mcp.acedata.cloud/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
If you prefer to run the server on your own machine:
# Install from PyPI
pip install mcp-midjourney
# or
uvx mcp-midjourney
# Set your API token
export ACEDATACLOUD_API_TOKEN="your_token_here"
# Run (stdio mode for Claude Desktop / local clients)
mcp-midjourney
# Run (HTTP mode for remote access)
mcp-midjourney --transport http --port 8000
{
"mcpServers": {
"midjourney": {
"command": "uvx",
"args": ["mcp-midjourney"],
"env": {
"ACEDATACLOUD_API_TOKEN": "your_token_here"
}
}
}
}
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.
| Tool | Description |
|---|---|
midjourney_imagine | Generate images from a text prompt (creates 2x2 grid) |
midjourney_transform | Transform images (upscale, variation, zoom, pan) |
midjourney_blend | Blend multiple images together |
midjourney_with_reference | Generate using a reference image as inspiration |
| Tool | Description |
|---|---|
midjourney_edit | Edit an existing image with text prompt |
midjourney_describe | Get AI descriptions of an image (reverse prompt) |
| Tool | Description |
|---|---|
midjourney_generate_video | Generate video from text and reference image |
midjourney_extend_video | Extend existing video to make it longer |
| Tool | Description |
|---|---|
midjourney_translate | Translate Chinese text to English for prompts |
midjourney_get_seed | Get the seed value of a generated image |
| Tool | Description |
|---|---|
midjourney_get_task | Query a single task status |
midjourney_get_tasks_batch | Query multiple tasks at once |
| Tool | Description |
|---|---|
midjourney_list_actions | List available API actions |
midjourney_get_prompt_guide | Get prompt writing guide |
midjourney_list_transform_actions | List transformation actions |
User: Create a cyberpunk city at night
Claude: I'll generate a cyberpunk city image for you.
[Calls midjourney_imagine with prompt="Cyberpunk city at night, neon lights, rain, futuristic, detailed --ar 16:9"]
User: Upscale the second image
Claude: I'll upscale the top-right image from the grid.
[Calls midjourney_transform with image_id and action="upscale2"]
User: Blend these two images: [url1] and [url2]
Claude: I'll blend these images together.
[Calls midjourney_blend with image_urls=[url1, url2]]
User: Animate this image [url] with gentle movement
Claude: I'll create a video from this image.
[Calls midjourney_generate_video with image_url and prompt="Gentle camera movement, cinematic"]
| Mode | Description |
|---|---|
fast | Recommended for most use cases (default) |
turbo | Faster generation, uses more credits |
relax | Slower generation, cheaper |
| Variable | Description | Default |
|---|---|---|
ACEDATACLOUD_API_TOKEN | API token from AceDataCloud | Required |
ACEDATACLOUD_API_BASE_URL | API base URL | https://api.acedata.cloud |
ACEDATACLOUD_OAUTH_CLIENT_ID | OAuth client ID (hosted mode) | — |
ACEDATACLOUD_PLATFORM_BASE_URL | Platform base URL | https://platform.acedata.cloud |
MIDJOURNEY_DEFAULT_MODE | Default generation mode | fast |
MIDJOURNEY_REQUEST_TIMEOUT | Request timeout in seconds | 1800 |
LOG_LEVEL | Logging level | INFO |
mcp-midjourney --help
Options:
--version Show version
--transport Transport mode: stdio (default) or http
--port Port for HTTP transport (default: 8000)
# Clone repository
git clone https://github.com/AceDataCloud/MidjourneyMCP.git
cd MidjourneyMCP
# Create virtual environment
python -m venv .venv
source .venv/bin/activate # or `.venv\Scripts\activate` on Windows
# Install with dev dependencies
pip install -e ".[dev,test]"
# Run unit tests
pytest
# Run with coverage
pytest --cov=core --cov=tools
# Run integration tests (requires API token)
pytest tests/test_integration.py -m integration
# Format code
ruff format .
# Lint code
ruff check .
# Type check
mypy core tools
# Install build dependencies
pip install -e ".[release]"
# Build package
python -m build
# Upload to PyPI
twine upload dist/*
MidjourneyMCP/
├── core/ # Core modules
│ ├── __init__.py
│ ├── client.py # HTTP client for Midjourney API
│ ├── config.py # Configuration management
│ ├── exceptions.py # Custom exceptions
│ ├── server.py # MCP server initialization
│ ├── types.py # Type definitions
│ └── utils.py # Utility functions
├── tools/ # MCP tool definitions
│ ├── __init__.py
│ ├── describe_tools.py # Image description tools
│ ├── edits_tools.py # Image editing tools
│ ├── imagine_tools.py # Image generation tools
│ ├── info_tools.py # Information tools
│ ├── task_tools.py # Task query tools
│ ├── translate_tools.py # Translation tools
│ └── video_tools.py # Video generation tools
├── prompts/ # MCP prompt templates
│ └── __init__.py
├── tests/ # Test suite
├── deploy/ # Deployment configs
│ └── production/
│ ├── deployment.yaml
│ ├── ingress.yaml
│ └── service.yaml
├── .env.example # Environment template
├── .gitignore
├── CHANGELOG.md
├── Dockerfile # Docker image for HTTP mode
├── docker-compose.yaml # Docker Compose config
├── LICENSE
├── main.py # Entry point
├── pyproject.toml # Project configuration
└── README.md
This server wraps the AceDataCloud Midjourney API:
Contributions are welcome! Please:
git checkout -b feature/amazing)git commit -m 'Add amazing feature')git push origin feature/amazing)MIT License - see LICENSE for details.
Made with love by AceDataCloud
ACEDATACLOUD_API_TOKEN*secretAPI token from Ace Data Cloud (https://platform.acedata.cloud)
miapre/html-to-figma-design-system
ie3jp/illustrator-mcp-server
coding-solo/godot-mcp
ivanmurzak/unity-mcp
yctimlin/mcp_excalidraw
figma/mcp-server-guide