> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# دليل تكامل Midjourney MCP

> midjourney MCP 服务器集成

[MCP (نموذج بروتوكول السياق)](https://modelcontextprotocol.io) هو بروتوكول سياق النموذج الذي أطلقته شركة Anthropic، والذي يسمح لنماذج الذكاء الاصطناعي (مثل Claude وGPT وغيرها) باستدعاء أدوات خارجية من خلال واجهات موحدة. من خلال خادم Midjourney MCP المقدم من XHuoAPI، يمكنك مباشرةً إنشاء وتحرير صور الذكاء الاصطناعي في عملاء الذكاء الاصطناعي مثل Claude Desktop وVS Code وCursor.

## نظرة عامة على الوظائف

يوفر خادم Midjourney MCP الوظائف الأساسية التالية:

* **توليد الصور (Imagine)** — إنشاء صور عالية الجودة من خلال نصوص توجيهية
* **تحرير الصور** — إجراء تعديلات محلية على الصور التي تم إنشاؤها
* **تحويل الصور** — تكبير، تصغير، وتحريك الصور الموجودة
* **دمج الصور (Blend)** — دمج عدة صور لإنشاء صورة جديدة
* **توليد صور مرجعية** — استخدام صور مرجعية لتوجيه عملية التوليد
* **وصف الصور (Describe)** — إنشاء وصف نصي بناءً على الصورة
* **ترجمة النصوص التوجيهية** — ترجمة النصوص التوجيهية من الصينية إلى الإنجليزية
* **الحصول على البذور** — الحصول على قيمة seed للصورة لإعادة إنتاجها
* **توليد الفيديو** — إنشاء فيديو ديناميكي بناءً على الصور
* **استعلام المهام** — مراقبة تقدم التوليد والحصول على النتائج

## التحضيرات المسبقة

قبل الاستخدام، تحتاج إلى الحصول على رمز API من XHuoAPI:

1. سجل أو قم بتسجيل الدخول إلى [منصة XHuoAPI](https://api.xhuoapi.ai)
2. انتقل إلى صفحة [API تخيل Midjourney](https://api.xhuoapi.ai/documents/midjourney-imagine)
3. انقر على "Acquire" للحصول على رمز API (تقدم أول طلب هدية مجانية)

## إعداد التثبيت

### الطريقة الأولى: تثبيت باستخدام pip (موصى به)

```bash theme={null}
pip install mcp-midjourney
```

### الطريقة الثانية: تثبيت من المصدر

```bash theme={null}
git clone https://github.com/XHuoAPI/MidjourneyMCP.git
cd MidjourneyMCP
pip install -e .
```

بعد الانتهاء من التثبيت، يمكنك استخدام الأمر `mcp-midjourney` لبدء الخدمة.

## الاستخدام في Claude Desktop

قم بتحرير ملف إعدادات Claude Desktop:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

أضف الإعدادات التالية:

```json theme={null}
{
  "mcpServers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}
```

إذا كنت تستخدم `uvx` (لا حاجة لتثبيت الحزمة مسبقًا):

```json theme={null}
{
  "mcpServers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}
```

بعد حفظ الإعدادات، أعد تشغيل Claude Desktop، وستتمكن من استخدام أدوات Midjourney في المحادثة.

## الاستخدام في VS Code / Cursor

قم بإنشاء ملف `.vscode/mcp.json` في دليل المشروع الجذري:

```json theme={null}
{
  "servers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}
```

أو استخدم `uvx`:

```json theme={null}
{
  "servers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}
```

## قائمة الأدوات المتاحة

| اسم الأداة                   | الوصف                                 |
| ---------------------------- | ------------------------------------- |
| `midjourney_imagine`         | إنشاء صور من خلال نصوص توجيهية        |
| `midjourney_edit`            | تحرير مناطق معينة من الصور الموجودة   |
| `midjourney_transform`       | تكبير، تصغير، وتحريك الصور الموجودة   |
| `midjourney_blend`           | دمج عدة صور في صورة واحدة             |
| `midjourney_with_reference`  | استخدام صورة مرجعية لتوليد صورة       |
| `midjourney_describe`        | إنشاء وصف نصي بناءً على الصورة        |
| `midjourney_translate`       | ترجمة النصوص التوجيهية إلى الإنجليزية |
| `midjourney_get_seed`        | الحصول على قيمة seed للصورة           |
| `midjourney_generate_video`  | إنشاء فيديو بناءً على الصور           |
| `midjourney_extend_video`    | تمديد الفيديو الموجود                 |
| `midjourney_get_task`        | استعلام عن حالة مهمة واحدة            |
| `midjourney_get_tasks_batch` | استعلام عن حالة المهام بشكل جماعي     |

## أمثلة على الاستخدام

بعد الانتهاء من الإعداد، يمكنك مباشرةً استدعاء هذه الوظائف بلغة طبيعية في عميل الذكاء الاصطناعي، مثل:

* "ساعدني في إنشاء صورة لمدينة بأسلوب سايبربانك في الليل"
* "قم بتغيير خلفية هذه الصورة إلى شاطئ البحر"
* "ادمج هذه الصور الأربع في صورة واحدة"
* "صف لي محتوى هذه الصورة"
* "اجعل هذه الصورة فيديو"
* "كبر هذه الصورة إلى النسخة الثانية"

## مزيد من المعلومات

* مستودع GitHub: [XHuoAPI/MidjourneyMCP](https://github.com/XHuoAPI/MidjourneyMCP)
* حزمة PyPI: [mcp-midjourney](https://pypi.org/project/mcp-midjourney/)
* وثائق API: [API توليد Midjourney](https://api.xhuoapi.ai/documents/midjourney)