Midjourney MCP Server

🎨 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个)

工具名称	描述	主要参数
`imagine_image`	生成图像	`prompt`, `aspect_ratio`, `base64_images`
`blend_images`	混合图像	`base64_images`, `dimensions`
`describe_image`	描述图像	`base64_image`
`change_image`	图像变换	`task_id`, `action`, `index`
`modal_edit`	高级编辑	`task_id`, `action`, `prompt`
`swap_face`	人脸替换	`source_image`, `target_image`

任务管理工具 (1个)

工具名称	描述	主要参数
`get_task_status`	任务状态查询	`task_id`

📁 项目结构

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

A complete Midjourney MCP server that provides image generation features through the GPTNB API, including text-to-image generation, image transformations, advanced editing, and face swapping capabilities.

Related MCP Servers

MCP-LOGO-GEN
sshtunnelvision
-
security
A
license
-
quality
MCP Tool Server for Logo Generation. This server provides logo generation capabilities using FAL AI, with tools for image generation, background removal, and image scaling.
Last updated -
159
Python
GPL 3.0
Stability AI MCP Server
tadasant
A
security
A
license
A
quality
An MCP Server that integrates with Stability AI's API to provide high-quality image generation, editing, and manipulation capabilities including background removal, outpainting, search-and-replace, and upscaling.
Last updated -
13
35
55
TypeScript
MIT License
OpenAI GPT Image MCP
SureScaleAI
-
security
A
license
-
quality
An MCP tool server that enables generating and editing images through OpenAI's image models, supporting text-to-image generation and advanced image editing (inpainting, outpainting) across various MCP-compatible clients.
Last updated -
19
TypeScript
MIT License
MCP Asset Generator
jbrower95
A
security
A
license
A
quality
An MCP server that allows Claude to use OpenAI's image generation capabilities (gpt-image-1) to create image assets for users, which is particularly useful for game and web development projects.
Last updated -
1
JavaScript
MIT License

View all related MCP servers