> ## 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 (Model Context Protocol)](https://modelcontextprotocol.io) — це протокол контексту моделі, розроблений компанією Anthropic, який дозволяє AI моделям (таким як Claude, GPT тощо) викликати зовнішні інструменти через стандартизований інтерфейс. Завдяки Midjourney MCP Server, наданому XHuoAPI, ви можете безпосередньо генерувати та редагувати AI зображення в таких AI клієнтах, як Claude Desktop, VS Code, Cursor тощо.

## Огляд функцій

Midjourney MCP Server надає такі основні функції:

* **Генерація зображень (Imagine)** — створення високоякісних зображень за текстовими підказками
* **Редагування зображень** — локальні зміни вже згенерованих зображень
* **Трансформація зображень** — збільшення, зменшення, переміщення існуючих зображень
* **Змішування зображень (Blend)** — об'єднання кількох зображень в нове
* **Генерація референсних зображень** — використання референсних зображень для керування генерацією
* **Опис зображень (Describe)** — створення текстового опису на основі зображення
* **Переклад підказок** — переклад китайських підказок на англійську
* **Отримання насіння** — отримання значення seed зображення для відтворення
* **Генерація відео** — створення динамічного відео на основі зображень
* **Запит завдань** — моніторинг прогресу генерації та отримання результатів

## Попередня підготовка

Перед використанням вам потрібно отримати XHuoAPI API Token:

1. Зареєструйтесь або увійдіть на [платформу XHuoAPI](https://api.xhuoapi.ai)
2. Перейдіть на сторінку [Midjourney Imagine API](https://api.xhuoapi.ai/documents/midjourney-imagine)
3. Натисніть «Acquire», щоб отримати API Token (перший запит надає безкоштовний ліміт)

## Встановлення та налаштування

### Спосіб 1: встановлення через pip (рекомендується)

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

### Спосіб 2: встановлення з вихідного коду

```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 Token"
      }
    }
  }
}
```

Якщо ви використовуєте `uvx` (не потрібно попередньо встановлювати пакет):

```json theme={null}
{
  "mcpServers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Збережіть конфігурацію та перезапустіть Claude Desktop, щоб використовувати інструменти Midjourney в діалозі.

## Використання в VS Code / Cursor

Створіть файл `.vscode/mcp.json` в кореневій директорії проекту:

```json theme={null}
{
  "servers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Або використовуйте `uvx`:

```json theme={null}
{
  "servers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

## Список доступних інструментів

| Назва інструменту            | Опис                                                      |
| ---------------------------- | --------------------------------------------------------- |
| `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` | Пакетний запит статусу завдань                            |

## Приклади використання

Після налаштування ви можете безпосередньо викликати ці функції природною мовою в AI клієнтах, наприклад:

* «Допоможіть мені згенерувати зображення міського нічного пейзажу в стилі кіберпанк»
* «Змініть фон цього зображення на пляж»
* «Змішайте ці чотири зображення в одне»
* «Опишіть, що на цьому зображенні»
* «Зробіть з цього зображення відео»
* «Збільшіть другий варіант цього зображення»

## Додаткова інформація

* Репозиторій GitHub: [XHuoAPI/MidjourneyMCP](https://github.com/XHuoAPI/MidjourneyMCP)
* Пакет PyPI: [mcp-midjourney](https://pypi.org/project/mcp-midjourney/)
* Документація API: [Midjourney генераційний API](https://api.xhuoapi.ai/documents/midjourney)