CAT
/MCP
SkillsMCPMarketplacesDigestToolsAdvertise

This week in Claude

Every Monday: Claude Code, Agent SDK, MCP, and the Anthropic platform moves worth your time.

Skills by Category
Frontend DevelopmentBackend & APIsTesting & QASecurityDevOps & CI/CDGit & Pull RequestsDocumentationCode Review & QualityAI & Agent BuildingSkill Development
MCP Servers by Category
Sales & MarketingWeb & Browser AutomationDatabasesAI & LLM ToolsCloud & InfrastructureCommunication & MessagingDeveloper ToolsDesign & CreativeDocuments & KnowledgeSearch & Web Crawling
Marketplaces by Category
AI Agents & OrchestrationLLM IntegrationDevelopment ToolsFrontend & UIBackend & APIsDatabasesTesting & Code QualityDevOps & CloudSecurity & ComplianceGit & Version Control

Cross AI Tools

Discover Claude Code plugins, extensions, and tools. Automatically updated directory of Anthropic Claude AI marketplaces with development tools, productivity plugins, and integrations.

Resources

  • Browse Skills
  • Browse MCP Servers
  • Browse Marketplaces
  • Plugins Reference

Community

  • About
  • Tools
  • Feedback
  • Privacy Policy
  • Advertise

Built for the Claude Code community with Claude Code by @mertduzgun

Independent project, not affiliated with Anthropic

Midjourney

acedatacloud/midjourneymcp
1315 toolsauthSTDIO, HTTPregistry active
Summary

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.

CodeRabbit
CodeRabbit
AI writes the code. CodeRabbit catches the slop.
Try For Free →
Keep your Mac awake
Keep your Mac awake
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Context.devContext.dev
Context.dev
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Make your agent a DeFi expert
Make your agent a DeFi expert
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make money from your Skills
Make money from your Skills
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
AppSignal
AppSignal
Monitor with ease. Code with confidence.
Start Free Trial →
CodeRabbit
CodeRabbit
AI writes the code. CodeRabbit catches the slop.
Try For Free →
Keep your Mac awake
Keep your Mac awake
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Context.devContext.dev
Context.dev
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Make your agent a DeFi expert
Make your agent a DeFi expert
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make money from your Skills
Make money from your Skills
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
AppSignal
AppSignal
Monitor with ease. Code with confidence.
Start Free Trial →

Tools

Public tool metadata for what this MCP can expose to an agent.

15 tools
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 params

Get 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...

Parameters* required
image_urlstring
URL of the image to describe. Must be a direct image URL (JPEG, PNG, GIF, etc.), not a web page containing an image.
midjourney_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 params

Edit 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...

Parameters* required
maskstring
Optional Base64-encoded mask image. White areas indicate regions to edit and regenerate.default:
modestring
Generation mode. 'fast' is recommended.one of fast · relax · turbodefault: fast
promptstring
Description of how to edit the image. Examples: 'A cat sitting on a table', 'Add a sunset in the background', 'Make it look like a watercolor painting'
image_urlstring
URL of the image to edit. Must be a direct image URL (not a web page).
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the edit is complete.
split_imagesboolean
If true, split the result into separate images returned via sub_image_urls.default: false
midjourney_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 params

Generate 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...

Parameters* required
hdboolean
Enable HD mode (V8 only). Generates higher resolution images at 4x cost. Requires version='8'.default: false
modestring
Generation mode. 'fast' is recommended for most use cases. 'turbo' is faster but uses more credits. 'relax' is slower but cheaper.one of fast · relax · turbodefault: fast
promptstring
Description of the image to generate. Be descriptive about style, subject, lighting, and composition. Examples: 'A majestic lion in a savanna at sunset, cinematic lighting', 'Cyberpunk city street at night, neon lights, rain, photorealistic', 'Abstract watercolor painting of mountains and clouds'
qualityvalue
Image quality level. For V8: '1' (standard) or '4' (ultra, 4x cost). For older versions: '.25', '.5', or '1'. HD + quality '4' = 16x cost.
timeoutvalue
Timeout in seconds for the API to return data. Default is 480.
versionvalue
Midjourney model version to use. '8' is the latest V8 Alpha with HD and ultra quality support. Leave unset to use Midjourney's default.
moodboardboolean
Whether using moodboard feature (V8 only, multiple reference images). Incurs 4x cost.default: false
translationboolean
If true, automatically translate non-English prompts to English for better results.default: false
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the image is generated.
split_imagesboolean
If true, split the 2x2 grid result into 4 separate images returned via sub_image_urls.default: false
style_referenceboolean
Whether the prompt includes --sref style reference. In V8 this incurs 4x cost.default: false
midjourney_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 params

Transform 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...

Parameters* required
maskstring
Base64-encoded mask image for variation_region action. White areas indicate regions to regenerate.default:
modestring
Generation mode for the transformation.one of fast · relax · turbodefault: fast
actionstring
Transformation action to perform. Options include: - upscale1/2/3/4: Upscale one of the 4 images (top-left=1, top-right=2, bottom-left=3, bottom-right=4) - upscale_2x/4x: Further upscale an already upscaled image by 2x or 4x - variation1/2/3/4: Create variations of one of the 4 images - variation_subtle/strong: Create subtle or strong variations after upscaling - reroll: Regenerate all 4 images with the same prompt - zoom_out_2x/1_5x: Zoom out the image by 2x or 1.5x - pan_left/right/up/down: Pan the image in a directionone of generate · upscale1 · upscale2 · upscale3 · upscale4 · upscale_2x
promptstring
Optional prompt for the transformation. Used with variation_region action.default:
image_idstring
ID of the image to transform. This is the 'image_id' field from a previous generation result.
midjourney_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 params

Blend 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: -...

Parameters* required
modestring
Generation mode.one of fast · relax · turbodefault: fast
promptstring
Description of how to blend the images. Examples: 'The bear is holding the chainsaw', 'Combine the face with the background'default:
image_urlsarray
List of image URLs to blend together. Supports 2-5 images. Images should be pure image URLs (not web pages containing images).
midjourney_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 params

Generate 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...

Parameters* required
modestring
Generation mode.one of fast · relax · turbodefault: fast
promptstring
Description of how to modify or reimagine the reference image. Examples: 'an illustration of a car parked on the beach --iw 2', 'in the style of Van Gogh'
reference_image_urlstring
URL of the reference image to use as a base. Must be a direct image URL (not a web page).
midjourney_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 params

Get 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...

Parameters* required
image_idstring
The ID of the generated image to get the seed for. This is the 'image_id' field from a previous imagine result.
midjourney_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 params

Query 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...

Parameters* required
task_idstring
The task ID returned from a generation request. This is the 'task_id' field from any midjourney_imagine, midjourney_describe, midjourney_edit, or midjourney_generate_video tool response.
midjourney_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 params

Query 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...

Parameters* required
task_idsarray
List of task IDs to query. Maximum recommended batch size is 50 tasks.
midjourney_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 params

Translate 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...

Parameters* required
contentstring
Chinese text to translate to English. This is useful for converting Chinese prompts to English for better Midjourney results.
midjourney_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 params

Generate 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...

Parameters* required
loopboolean
If true, generate a looping video where the end seamlessly connects to the beginning.default: false
modestring
Generation mode. 'fast' is recommended for most use cases.one of fast · relax · turbodefault: fast
promptstring
Description of the video to generate. Examples: 'A cat walking on a table', 'Ocean waves crashing on the shore', 'Timelapse of clouds moving'
image_urlstring
URL of the first frame reference image. This image will be used as the starting point for the video.
resolutionstring
Video resolution. '720p' or '480p'.one of 480p · 720pdefault: 720p
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the video is generated.
end_image_urlstring
Optional URL of the last frame reference image. Use this to control where the video ends.default:
midjourney_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 params

Extend 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...

Parameters* required
modestring
Generation mode.one of fast · relax · turbodefault: fast
promptstring
Description for the video extension. This guides how the video should continue.
video_idstring
ID of the video to extend. This is the 'video_id' field from a previous video generation result.
video_indexinteger
Index of the video to extend from the video_urls array. 0-indexed, default is 0 (first video).default: 0
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the video extension is complete.
end_image_urlstring
Optional URL of an image to use as the final frame of the extended video.default:

MidjourneyMCP

PyPI version PyPI downloads Python 3.10+ License: MIT MCP

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

Tool Reference

ToolDescription
midjourney_imagineGenerate AI images from a text prompt using Midjourney.
midjourney_transformTransform an existing Midjourney image with various operations.
midjourney_blendBlend multiple images together using Midjourney.
midjourney_with_referenceGenerate images using a reference image as inspiration.
midjourney_editEdit an existing image using Midjourney.
midjourney_describeGet AI-generated descriptions of an image.
midjourney_generate_videoGenerate a video from text prompt and reference image using Midjourney.
midjourney_extend_videoExtend an existing Midjourney video to make it longer.
midjourney_translateTranslate Chinese text to English for use as Midjourney prompts.
midjourney_get_seedGet the seed value of a previously generated Midjourney image.
midjourney_get_taskQuery the status and result of a Midjourney generation task.
midjourney_get_tasks_batchQuery multiple Midjourney generation tasks at once.
midjourney_list_actionsList all available Midjourney API actions and corresponding tools.
midjourney_get_prompt_guideGet guidance on writing effective prompts for Midjourney.
midjourney_list_transform_actionsList all available transformation actions for Midjourney images.

Quick Start

1. Get Your API Token

  1. Sign up at AceDataCloud Platform
  2. Go to the API documentation page
  3. Click "Acquire" to get your API token
  4. Copy the token for use below

2. Use the Hosted Server (Recommended)

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.

Claude.ai

Connect directly on Claude.ai with OAuth — no API token needed:

  1. Go to Claude.ai Settings → Integrations → Add More
  2. Enter the server URL: https://midjourney.mcp.acedata.cloud/mcp
  3. Complete the OAuth login flow
  4. Start using the tools in your conversation

Claude Desktop

Add 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"
      }
    }
  }
}

Cursor / Windsurf

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"
      }
    }
  }
}

VS Code (Copilot)

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.

JetBrains IDEs

  1. Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
  2. Click Add → HTTP
  3. Paste:
{
  "mcpServers": {
    "midjourney": {
      "url": "https://midjourney.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Claude Code

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"
      }
    }
  }
}

Cline

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"
      }
    }
  }
}

Amazon Q Developer

Add to your MCP configuration:

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

Roo Code

Add to Roo Code MCP settings:

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

Continue.dev

Add to .continue/config.yaml:

mcpServers:
  - name: midjourney
    type: streamable-http
    url: https://midjourney.mcp.acedata.cloud/mcp
    headers:
      Authorization: "Bearer YOUR_API_TOKEN"

Zed

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"
        }
      }
    }
  }
}

cURL Test

# 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"}}}'

3. Or Run Locally (Alternative)

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

Claude Desktop (Local)

{
  "mcpServers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your_token_here"
      }
    }
  }
}

Docker (Self-Hosting)

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.

Available Tools

Image Generation

ToolDescription
midjourney_imagineGenerate images from a text prompt (creates 2x2 grid)
midjourney_transformTransform images (upscale, variation, zoom, pan)
midjourney_blendBlend multiple images together
midjourney_with_referenceGenerate using a reference image as inspiration

Image Editing

ToolDescription
midjourney_editEdit an existing image with text prompt
midjourney_describeGet AI descriptions of an image (reverse prompt)

Video

ToolDescription
midjourney_generate_videoGenerate video from text and reference image
midjourney_extend_videoExtend existing video to make it longer

Utility

ToolDescription
midjourney_translateTranslate Chinese text to English for prompts
midjourney_get_seedGet the seed value of a generated image

Tasks

ToolDescription
midjourney_get_taskQuery a single task status
midjourney_get_tasks_batchQuery multiple tasks at once

Information

ToolDescription
midjourney_list_actionsList available API actions
midjourney_get_prompt_guideGet prompt writing guide
midjourney_list_transform_actionsList transformation actions

Usage Examples

Generate Image from Prompt

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"]

Upscale an Image

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"]

Blend Multiple Images

User: Blend these two images: [url1] and [url2]

Claude: I'll blend these images together.
[Calls midjourney_blend with image_urls=[url1, url2]]

Generate Video

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"]

Generation Modes

ModeDescription
fastRecommended for most use cases (default)
turboFaster generation, uses more credits
relaxSlower generation, cheaper

Configuration

Environment Variables

VariableDescriptionDefault
ACEDATACLOUD_API_TOKENAPI token from AceDataCloudRequired
ACEDATACLOUD_API_BASE_URLAPI base URLhttps://api.acedata.cloud
ACEDATACLOUD_OAUTH_CLIENT_IDOAuth client ID (hosted mode)—
ACEDATACLOUD_PLATFORM_BASE_URLPlatform base URLhttps://platform.acedata.cloud
MIDJOURNEY_DEFAULT_MODEDefault generation modefast
MIDJOURNEY_REQUEST_TIMEOUTRequest timeout in seconds1800
LOG_LEVELLogging levelINFO

Command Line Options

mcp-midjourney --help

Options:
  --version          Show version
  --transport        Transport mode: stdio (default) or http
  --port             Port for HTTP transport (default: 8000)

Development

Setup Development Environment

# 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 Tests

# 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

Code Quality

# Format code
ruff format .

# Lint code
ruff check .

# Type check
mypy core tools

Build & Publish

# Install build dependencies
pip install -e ".[release]"

# Build package
python -m build

# Upload to PyPI
twine upload dist/*

Project Structure

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

API Reference

This server wraps the AceDataCloud Midjourney API:

  • Midjourney Imagine API - Image generation
  • Midjourney Describe API - Image description
  • Midjourney Tasks API - Task queries
  • Midjourney Edits API - Image editing
  • Midjourney Videos API - Video generation
  • Midjourney Translate API - Translation

Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing)
  5. Open a Pull Request

License

MIT License - see LICENSE for details.

Links

  • AceDataCloud Platform
  • Midjourney Official
  • Model Context Protocol
  • MCP Python SDK

Made with love by AceDataCloud

Featured
CodeRabbit
CodeRabbit
AI writes the code. CodeRabbit catches the slop.
Try For Free →
Keep your Mac awake
Keep your Mac awake
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Context.devContext.dev
Context.dev
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Make your agent a DeFi expert
Make your agent a DeFi expert
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make money from your Skills
Make money from your Skills
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
AppSignal
AppSignal
Monitor with ease. Code with confidence.
Start Free Trial →

Configuration

ACEDATACLOUD_API_TOKEN*secret

API token from Ace Data Cloud (https://platform.acedata.cloud)

Categories
Design & Creative
Registryactive
Packagemcp-midjourney
TransportSTDIO, HTTP
AuthRequired
UpdatedJun 9, 2026
View on GitHub

Related Design & Creative MCP Servers

View all →
HTML to Figma — Design System

miapre/html-to-figma-design-system

Translate HTML prototypes into Figma using your design system's real components and tokens.
3
Illustrator Mcp Server

ie3jp/illustrator-mcp-server

Read, manipulate, and export Adobe Illustrator design data. 26 tools. macOS | Windows.
44
Godot

coding-solo/godot-mcp

MCP server for interfacing with Godot game engine. Provides tools for launching the editor, running projects, and capturing debug output.
3.7k
Unity Mcp

ivanmurzak/unity-mcp

Make 3D games in Unity Engine with AI. MCP Server + Plugin for Unity Editor and Unity games.
3.1k
Excalidraw

yctimlin/mcp_excalidraw

Provides an Excalidraw canvas exposed via MCP for real-time diagramming and element CRUD from AI agents.
1.9k
Figma MCP Server

figma/mcp-server-guide

The Figma MCP server brings Figma design context directly into your AI workflow.
1.6k