Midjourney MCP (Model Context Protocol) 服务器功能完备,借助 GPTNB API 实现 Midjourney 图像生成功能,能够满足多样化的图像创作需求。
# 克隆项目
git clone
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
工具名称 | 描述 | 主要参数 |
---|---|---|
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 |
工具名称 | 描述 | 主要参数 |
---|---|---|
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
直接启动。requirements.txt
管理依赖。# 通过 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!
GPT-3.0 License