README.md•3.67 kB
# 🎨 Midjourney MCP Server
一个功能完整的 Midjourney MCP (Model Context Protocol) 服务器，通过 GPTNB API 提供 Midjourney 图像生成功能。
## ✨ 特性
- 🖼️ **图像生成**: 通过文本提示生成高质量图像
- 🔄 **图像变换**: 支持放大、变体、重新生成等操作
- 🎭 **高级编辑**: 缩放、平移、修复等编辑功能
- 👥 **人脸替换**: 智能人脸交换功能
- 📝 **图像描述**: AI 图像内容分析
- 🔧 **提示优化**: 智能提示词优化建议
- 📊 **任务管理**: 简洁高效的任务状态跟踪
## 🚀 快速开始
### 环境要求
- Python 3.10+
- pip
- Node.js (用于 MCP Inspector，可选)
### 安装
```bash
# 克隆项目
git clone <repository-url>
cd mj-mcp
# 安装依赖
pip install -r requirements.txt
# 或安装为可编辑包
pip install -e .
```
### 配置
设置环境变量：
```bash
# 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` 文件：
```env
GPTNB_API_KEY=your_api_key_here
GPTNB_BASE_URL=https://aiclound.vip
```
## 🚀 运行
### 启动服务器
```bash
# 直接运行
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个核心工具，专注于实用功能，避免冗余
## 📝 使用示例
### 基本图像生成
```python
# 通过 MCP 客户端调用
result = await session.call_tool("imagine_image", {
"prompt": "a beautiful sunset over mountains, digital art",
"aspect_ratio": "16:9"
})
```
### 图像变体
```python
# 生成变体
result = await session.call_tool("change_image", {
"task_id": "previous_task_id",
"action": "VARIATION",
"index": 1
})
```
## 🤝 贡献
欢迎提交 Issue 和 Pull Request！
## 📄 许可证
GPL-3.0 License