Midjourney MCP

🚀 🎨 Midjourney MCP Server

Midjourney MCP (Model Context Protocol) 服務器功能完備，藉助 GPTNB API 實現 Midjourney 圖像生成功能，能夠滿足多樣化的圖像創作需求。

🚀 快速開始

環境要求

• 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

✨ 主要特性

• 🖼️ 圖像生成：依據文本提示生成高質量圖像。
• 🔄 圖像變換：支持放大、變體、重新生成等操作。
• 🎭 高級編輯：具備縮放、平移、修復等編輯功能。
• 👥 人臉替換：擁有智能人臉交換功能。
• 📝 圖像描述：可進行 AI 圖像內容分析。
• 🔧 提示優化：提供智能提示詞優化建議。
• 📊 任務管理：實現簡潔高效的任務狀態跟蹤。

🛠️ 可用工具 (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！

📄 許可證

GPT-3.0 License