Vai al contenuto principale

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.

MCP (Model Context Protocol) è 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
  2. Vai alla pagina Seedream Images API
  3. Clicca su “Acquire” per ottenere il token API (la prima richiesta include un credito gratuito)

​
Installazione e configurazione

​
Metodo 1: installazione pip (consigliato)

pip install mcp-seedream-pro

​
Metodo 2: installazione da sorgente

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: 
{
  "mcpServers": {
    "seedream": {
      "command": "mcp-seedream-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "tuo API Token"
      }
    }
  }
}
Se utilizzi uvx (non richiede l’installazione preventiva di pacchetti): 
{
  "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: 
{
  "servers": {
    "seedream": {
      "command": "mcp-seedream-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "tuo API Token"
      }
    }
  }
}
Oppure usa uvx: 
{
  "servers": {
    "seedream": {
      "command": "uvx",
      "args": ["mcp-seedream-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "tuo API Token"
      }
    }
  }
}

​
Elenco degli strumenti disponibili

Nome strumentoDescrizione
seedream_generate_imageGenera immagini da prompt testuali
seedream_edit_imageModifica o edita immagini esistenti
seedream_get_taskConsulta lo stato di un singolo task
seedream_get_tasks_batchConsulta in batch lo stato di più task
seedream_list_modelsElenca tutti i modelli disponibili e le loro capacità
seedream_list_sizesElenca 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