Transform your Claude Desktop into a powerful AI art studio! This MCP server seamlessly integrates Midjourney's image generation capabilities, allowing you to create stunning artwork directly through natural conversation with Claude.

• 🚀 Zero-config setup - Works out of the box with npx
• 🎯 Midjourney-focused - Optimized specifically for Midjourney API
• 🖼️ Direct image display - See your creations instantly in Claude
• 🔧 Full parameter support - Access all Midjourney features
• ⚡ Real-time tracking - Monitor generation progress
• 🎨 Advanced tools - Upscale, variations, blending, and more

npx midjourney-mcp@latest

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

{
  "mcpServers": {
    "midjourney": {
      "command": "npx",
      "args": ["midjourney-mcp@latest"],
      "env": {
        "MJ_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop and try:

"Create a cyberpunk cityscape at night with neon lights, 16:9 aspect ratio"

🎉 That's it! You're now ready to generate amazing AI artwork through Claude.

# Run directly without installation (always gets latest version)
npx midjourney-mcp@latest

# Install globally
npm install -g midjourney-mcp

# Run anywhere
midjourney-mcp

git clone https://github.com/z23cc/MJ-MCP.git
cd MJ-MCP
npm install
npm run build
npm run dev

1. 🌐 Visit https://aiclound.vip
2. 📝 Register an account or log in
3. 💳 Purchase credits or choose a plan
4. 🔑 Generate your API key from the dashboard
5. 📋 Copy the key (format: sk-xxxxxxxxxx)

⚠️ Important: Make sure your chosen provider supports the Midjourney API format that this MCP server expects. If you use a different provider, you may need to update the MJ_BASE_URL environment variable.

Once you have your API key, you can use it in two ways:

Method 1: Environment Variable

export MJ_API_KEY="sk-your-actual-api-key-here"

Method 2: Claude Desktop Config (Recommended) Add it directly to your claude_desktop_config.json as shown in the Quick Start section.

If you're using a different API provider (not AICloud), you may need to customize the base URL:

{
  "mcpServers": {
    "midjourney": {
      "command": "npx",
      "args": ["midjourney-mcp@latest"],
      "env": {
        "MJ_API_KEY": "your-api-key-here",
        "MJ_BASE_URL": "https://your-provider-api-url.com"
      }
    }
  }
}

Common API Base URLs:

• AICloud: https://aiclound.vip (default)
• Custom: Check your provider's documentation

• 🎨 Text-to-Image: Create stunning artwork from text descriptions
• 📐 Aspect Ratios: Support for all standard ratios (1:1, 16:9, 9:16, etc.)
• 🎭 Style Control: Raw, stylize, and model-specific styling
• 🎲 Chaos & Variation: Control randomness and artistic interpretation

• 📈 Upscaling: Enhance image resolution (U1-U4 buttons)
• 🔄 Variations: Generate alternative versions (V1-V4 buttons)
• 🎭 Blending: Combine multiple images seamlessly
• 📝 Image Description: Reverse-engineer prompts from images
• ⚡ Custom Actions: Zoom, pan, and other advanced operations

• 📊 Real-time Progress: Track generation status with duration
• 🖼️ Direct Display: Images appear instantly in Claude
• 🔍 Stuck Task Detection: Automatic warnings for long-running tasks
• 💡 Smart Suggestions: Helpful tips and next steps

"Create a majestic dragon flying over a medieval castle, 16:9 aspect ratio, high quality"

"Check the status of task 1748526068622289"

"Upscale image 1 from my last generation"

"Create variations of image 2"

"Reroll my last generation"

"Blend these two images together with a 16:9 aspect ratio"

"Describe this image and suggest prompts"

"Zoom out on my last generation"

"Create a beautiful sunset over mountains with 16:9 aspect ratio"
"Generate a portrait of a cat in high quality using niji model"
"Make an abstract art piece with high chaos and stylization"

💡 Pro Tip: Always use npx midjourney-mcp@latest to ensure you're running the newest version with the latest features and bug fixes!

"Check the status of task 1748519117239161"
"Upscale image 1 from my last generation"
"Create variations of image 2"
"Reroll my last generation for different results"

"Blend these two landscape photos together"
"Describe this image and suggest similar prompts"
"Zoom out on the generated image"

1. Generate: "Create a cyberpunk cityscape, neon lights, 16:9"
2. Check Status: "How is my generation going?"
3. Upscale: "Upscale image 3, it looks amazing!"
4. Variations: "Create variations of image 1"

• 🚀 Server Startup: MCP protocol compliance verified
• 🛠️ All 8 Tools: Registered and responding correctly
• 🎨 Image Generation: Successfully tested with task 1748526068622289
• 📊 Status Tracking: Real-time progress monitoring working
• 🔧 Parameter Validation: Comprehensive error handling
• 🔐 API Authentication: Secure communication established
• 🖥️ Claude Desktop: Integration tested and verified

✅ Prompt: "画个小猫：一只可爱的小猫，用卡通风格绘制，带有柔和的色彩和梦幻般的背景"
✅ Parameters: 1:1 aspect ratio, medium quality
✅ Result: Task completed successfully in 3m 20s
✅ Actions: U1-U4 upscale and V1-V4 variation options available

midjourney-mcp/
├── src/
│   ├── index.ts              # 🚀 Main server entry point
│   ├── tools/
│   │   └── midjourney.ts     # 🎨 Midjourney tool implementations
│   ├── types/
│   │   └── midjourney.ts     # 📝 TypeScript definitions
│   └── utils/
│       └── config.ts         # ⚙️ Configuration management
├── build/                    # 📦 Compiled JavaScript output
├── package.json              # 📋 Project configuration
└── tsconfig.json            # 🔧 TypeScript configuration

npm run build      # 🔨 Compile TypeScript to JavaScript
npm run watch      # 👀 Watch for changes and recompile
npm run dev        # 🚀 Build and run the server locally
npm run inspector  # 🔍 Debug with MCP inspector tool

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

• 📖 Documentation: Check this README for comprehensive guides
• 🐛 Issues: Report bugs on GitHub Issues
• 💡 Feature Requests: Suggest improvements via GitHub Issues
• 📧 Contact: Reach out to the maintainer for direct support

• 📦 npm Package: https://www.npmjs.com/package/midjourney-mcp
• 🔗 MCP Protocol: https://modelcontextprotocol.io/
• 🎨 Midjourney: https://midjourney.com/
• 🤖 Claude Desktop: https://claude.ai/
• 🔑 Get API Key: https://aiclound.vip (Recommended provider)

This project is licensed under the MIT License - see the LICENSE file for details.

• ✅ Commercial use allowed
• ✅ Modification allowed
• ✅ Distribution allowed
• ✅ Private use allowed
• ❌ Liability not provided
• ❌ Warranty not provided