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

# Guida all'integrazione Seedream MCP

> seedream MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) è un protocollo di contesto modello sviluppato da Anthropic, che consente ai modelli AI (come Claude, GPT, ecc.) di chiamare strumenti esterni tramite un'interfaccia standardizzata. Attraverso il Seedream MCP Server fornito da XHuoAPI, puoi utilizzare direttamente la generazione e modifica di immagini AI di ByteDance Seedream in client AI come Claude Desktop, VS Code, Cursor, ecc.

## Panoramica delle funzionalità

Seedream MCP Server offre le seguenti funzionalità principali:

* **Generazione di immagini da testo** — genera immagini di alta qualità da prompt testuali (supporta prompt in cinese e inglese)
* **Modifica immagini** — modifica stile, sfondo, attributi e altro di immagini esistenti
* **Prova virtuale di abbigliamento** — applica capi di abbigliamento a foto di persone
* **Supporto multi-modello** — supporta modelli Seedream v4.5, v4.0, v3.0 T2I, SeedEdit v3.0 I2I, ecc.
* **Varie risoluzioni** — supporta risoluzioni 1K, 2K, 4K e risoluzioni adattive
* **Controllo del seed** — riproducibilità dei risultati tramite parametro seed
* **Query attività** — monitora lo stato di generazione e ottieni i risultati

## Prerequisiti

Prima dell'uso, devi ottenere un API Token XHuoAPI:

1. Registrati o accedi alla [piattaforma XHuoAPI](https://api.xhuoapi.ai)
2. Vai alla pagina [Seedream Images API](https://api.xhuoapi.ai/documents/seedream-images)
3. Clicca su "Acquire" per ottenere il token API (la prima richiesta include un credito gratuito)

## Installazione e configurazione

### Metodo 1: installazione pip (consigliato)

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

### Metodo 2: installazione da sorgente

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

Dopo l'installazione, puoi avviare il servizio con il comando `mcp-seedream-pro`.

## Uso in Claude Desktop

Modifica il file di configurazione di Claude Desktop:

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

Aggiungi la seguente configurazione:

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

Se utilizzi `uvx` (non richiede l'installazione preventiva di pacchetti):

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

Salva la configurazione e riavvia Claude Desktop per utilizzare gli strumenti Seedream nelle conversazioni.

## Uso in VS Code / Cursor

Crea `.vscode/mcp.json` nella radice del progetto:

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

Oppure usa `uvx`:

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

## Elenco degli strumenti disponibili

| Nome strumento             | Descrizione                                             |
| -------------------------- | ------------------------------------------------------- |
| `seedream_generate_image`  | Genera immagini da prompt testuali                      |
| `seedream_edit_image`      | Modifica o edita immagini esistenti                     |
| `seedream_get_task`        | Consulta lo stato di un singolo task                    |
| `seedream_get_tasks_batch` | Consulta in batch lo stato di più task                  |
| `seedream_list_models`     | Elenca tutti i modelli disponibili e le loro capacità   |
| `seedream_list_sizes`      | Elenca le dimensioni e risoluzioni immagini disponibili |

## Esempi d'uso

Dopo la configurazione, puoi chiamare queste funzionalità direttamente in linguaggio naturale nei client AI, ad esempio:

* "Per favore genera un paesaggio in stile pittura a inchiostro con Seedream"
* "Cambia lo sfondo di questa foto in un cielo stellato"
* "Genera un ritratto 4K ad alta definizione con Seedream v4.5"
* "Applica virtualmente questo capo di abbigliamento a questa foto"

## Ulteriori informazioni

* Repository GitHub: [XHuoAPI/SeedreamMCP](https://github.com/XHuoAPI/SeedreamMCP)
* Pacchetto PyPI: [mcp-seedream-pro](https://pypi.org/project/mcp-seedream-pro/)
* Documentazione API: [Seedream Image Generation API](https://api.xhuoapi.ai/documents/seedream)