> ## 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에서 출시한 모델 컨텍스트 프로토콜로, AI 모델(예: Claude, GPT 등)이 표준화된 인터페이스를 통해 외부 도구를 호출할 수 있도록 합니다. XHuoAPI에서 제공하는 Midjourney MCP 서버를 통해 Claude Desktop, VS Code, Cursor 등 AI 클라이언트에서 직접 AI 이미지를 생성하고 편집할 수 있습니다.

## 기능 개요

Midjourney MCP 서버는 다음과 같은 핵심 기능을 제공합니다:

* **이미지 생성(Imagine)** — 텍스트 프롬프트를 통해 고품질 이미지를 생성
* **이미지 편집** — 생성된 이미지의 일부를 수정
* **이미지 변환** — 기존 이미지를 확대, 축소, 이동
* **이미지 혼합(Blend)** — 여러 이미지를 결합하여 새로운 이미지 생성
* **참조 이미지 생성** — 참조 이미지를 사용하여 생성 유도
* **이미지 설명(Describe)** — 이미지를 기반으로 텍스트 설명 생성
* **프롬프트 번역** — 중국어 프롬프트를 영어로 번역
* **시드 가져오기** — 이미지를 재현하기 위한 시드 값 가져오기
* **비디오 생성** — 이미지를 기반으로 동적 비디오 생성
* **작업 조회** — 생성 진행 상황 모니터링 및 결과 가져오기

## 사전 준비

사용하기 전에 XHuoAPI API 토큰을 확보해야 합니다:

1. [XHuoAPI 플랫폼](https://api.xhuoapi.ai)에서 등록 또는 로그인
2. [Midjourney Imagine API](https://api.xhuoapi.ai/documents/midjourney-imagine) 페이지로 이동
3. 「Acquire」를 클릭하여 API 토큰을 획득(첫 신청 시 무료 크레딧 제공)

## 설치 구성

### 방법 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 토큰"
      }
    }
  }
}
```

`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`        | 이미지의 시드 값 가져오기      |
| `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)