> ## 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)