Midjourney MCP

🚀 🎨 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