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

# Руководство по интеграции Seedream MCP

> seedream MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) — это протокол контекста модели, разработанный Anthropic, который позволяет AI-моделям (таким как Claude, GPT и др.) вызывать внешние инструменты через стандартизированный интерфейс. С помощью Seedream MCP Server от XHuoAPI вы можете напрямую использовать генерацию и редактирование AI-изображений Seedream от ByteDance в клиентах AI, таких как Claude Desktop, VS Code, Cursor и других.

## Обзор функций

Seedream MCP Server предоставляет следующие основные возможности:

* **Генерация изображений из текста** — создание высококачественных изображений по текстовым подсказкам (поддерживаются китайский и английский языки)
* **Редактирование изображений** — изменение стиля, фона, свойств существующих изображений
* **Виртуальная примерка одежды** — наложение одежды на фотографии людей
* **Поддержка нескольких моделей** — Seedream v4.5, v4.0, v3.0 T2I, SeedEdit v3.0 I2I и др.
* **Различные разрешения** — поддержка 1K, 2K, 4K и адаптивных разрешений
* **Управление seed-параметром** — воспроизводимые результаты генерации
* **Запросы задач** — мониторинг прогресса и получение результатов

## Предварительные требования

Для использования необходимо получить API Token XHuoAPI:

1. Зарегистрируйтесь или войдите на [XHuoAPI Platform](https://api.xhuoapi.ai)
2. Перейдите на страницу [Seedream Images API](https://api.xhuoapi.ai/documents/seedream-images)
3. Нажмите «Acquire» для получения API Token (при первом запросе предоставляется бесплатный лимит)

## Установка и настройка

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

```bash theme={null}
pip install mcp-seedream-pro
```

### Способ 2: установка из исходников

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

После установки запустите сервис командой `mcp-seedream-pro`.

## Использование в Claude Desktop

Отредактируйте конфигурационный файл Claude Desktop:

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

Добавьте следующую конфигурацию:

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

Если используете `uvx` (без необходимости предварительной установки пакетов):

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

Сохраните изменения и перезапустите Claude Desktop, после чего можно использовать инструменты Seedream в диалогах.

## Использование в VS Code / Cursor

Создайте файл `.vscode/mcp.json` в корне проекта:

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

Или с использованием `uvx`:

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

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

| Название инструмента       | Описание                                           |
| -------------------------- | -------------------------------------------------- |
| `seedream_generate_image`  | Генерация изображения по тексту                    |
| `seedream_edit_image`      | Редактирование или изменение изображения           |
| `seedream_get_task`        | Запрос статуса одной задачи                        |
| `seedream_get_tasks_batch` | Пакетный запрос статусов задач                     |
| `seedream_list_models`     | Список всех доступных моделей и их возможностей    |
| `seedream_list_sizes`      | Список доступных размеров и разрешений изображений |

## Примеры использования

После настройки вы можете напрямую вызывать функции на естественном языке в AI-клиентах, например:

* «Помоги сгенерировать пейзаж в стиле туши с помощью Seedream»
* «Измени фон этой фотографии на звездное небо»
* «Сгенерируй 4K портрет высокого качества с Seedream v4.5»
* «Виртуально примерить эту одежду на фотографию»

## Дополнительная информация

* Репозиторий GitHub: [XHuoAPI/SeedreamMCP](https://github.com/XHuoAPI/SeedreamMCP)
* Пакет PyPI: [mcp-seedream-pro](https://pypi.org/project/mcp-seedream-pro/)
* Документация API: [Seedream Image Generation API](https://api.xhuoapi.ai/documents/seedream)