What is Midjourney Mcp

Midjourney MCP is a fully functional Model Context Protocol server that provides image generation capabilities through the GPTNB API.

Use cases

Use cases include generating unique artwork based on user prompts, creating marketing visuals, enhancing images through editing, and performing intelligent face swaps in images.

How to use

To use Midjourney MCP, clone the repository, install the dependencies, set up the environment variables for the GPTNB API, and then run the server using Python.

Key features

Key features include high-quality image generation from text prompts, image transformations (such as upscaling and variations), advanced editing tools, intelligent face swapping, AI image content analysis, prompt optimization suggestions, and efficient task management.

Where to use

Midjourney MCP can be used in various fields including digital art creation, content generation for marketing, social media imagery, and any application requiring automated image generation and editing.

🎨 Midjourney MCP Server

一个功能完整的 Midjourney MCP (Model Context Protocol) 服务器，通过 GPTNB API 提供 Midjourney 图像生成功能。

✨ 特性

• 🖼️ 图像生成: 通过文本提示生成高质量图像
• 🔄 图像变换: 支持放大、变体、重新生成等操作
• 🎭 高级编辑: 缩放、平移、修复等编辑功能
• 👥 人脸替换: 智能人脸交换功能
• 📝 图像描述: AI 图像内容分析
• 🔧 提示优化: 智能提示词优化建议
• 📊 任务管理: 简洁高效的任务状态跟踪

🚀 快速开始

环境要求

• Python 3.10+
• pip
• Node.js (用于 MCP Inspector，可选)

安装

# 克隆项目
git clone <repository-url>
cd mj-mcp

# 安装依赖
pip install -r requirements.txt

# 或安装为可编辑包
pip install -e .

配置

设置环境变量：

# Windows
set GPTNB_API_KEY=your_api_key_here
set GPTNB_BASE_URL=https://aiclound.vip

# Linux/Mac
export GPTNB_API_KEY=your_api_key_here
export GPTNB_BASE_URL=https://aiclound.vip

或创建 .env 文件：

GPTNB_API_KEY=your_api_key_here
GPTNB_BASE_URL=https://aiclound.vip

🚀 运行

启动服务器

# 直接运行
python src/server.py

# 或使用MCP开发工具
npx @modelcontextprotocol/inspector python src/server.py

🛠️ 可用工具 (7个)

核心图像生成工具 (6个)

任务管理工具 (1个)

📁 项目结构

mj-mcp/
├── src/                    # 源代码目录
│   ├── server.py          # MCP 服务器主入口
│   ├── client.py          # GPTNB API 客户端
│   ├── service.py         # 业务逻辑服务
│   ├── config.py          # 配置管理
│   ├── models.py          # 数据模型
│   ├── task_handler.py    # 任务处理器
│   ├── exceptions.py      # 异常定义
│   └── utils.py           # 工具函数
├── requirements.txt       # 项目依赖
├── setup.py              # 安装配置
└── README.md             # 项目文档

🔧 开发

代码结构

项目采用简化的扁平化结构，符合 MCP 协议最佳实践：

• 无包结构: 移除了不必要的 __init__.py 和 __main__.py
• 直接入口: 通过 python src/server.py 直接启动
• 现代依赖: 使用最新版本的 MCP SDK (1.9.1)
• 简洁配置: 使用传统的 requirements.txt 管理依赖
• 精简工具集: 7个核心工具，专注于实用功能，避免冗余

📝 使用示例

基本图像生成

# 通过 MCP 客户端调用
result = await session.call_tool("imagine_image", {
    "prompt": "a beautiful sunset over mountains, digital art",
    "aspect_ratio": "16:9"
})

图像变体

# 生成变体
result = await session.call_tool("change_image", {
    "task_id": "previous_task_id",
    "action": "VARIATION",
    "index": 1
})

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

GPL-3.0 License