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 del modello lanciato da Anthropic, che consente ai modelli AI (come Claude, GPT, ecc.) di chiamare strumenti esterni tramite interfacce standardizzate. Attraverso il Sora MCP Server fornito da XHuoAPI, puoi utilizzare direttamente OpenAI Sora per generare video AI in client AI come Claude Desktop, VS Code, Cursor, ecc.

​
Panoramica delle funzionalità

Il Sora MCP Server offre le seguenti funzionalità principali:
  • Generazione video da testo — Genera video di alta qualità tramite suggerimenti testuali
  • Generazione video da immagini — Genera video basati su immagini
  • Video con coerenza del personaggio — Mantiene la coerenza del personaggio utilizzando immagini di riferimento
  • Generazione asincrona — Supporta l’invio di compiti asincroni e la consultazione dei risultati
  • Varie orientazioni video — Supporta orizzontale (landscape) e verticale (portrait)
  • Consultazione dei compiti — Monitora il progresso della generazione e ottiene risultati

​
Preparazione preliminare

Prima di utilizzare, devi ottenere il Token API di XHuoAPI:
  1. Registrati o accedi alla piattaforma XHuoAPI
  2. Vai alla pagina Sora Videos API
  3. Clicca su “Acquire” per ottenere il Token API (il primo acquisto include un credito gratuito)

​
Installazione e configurazione

​
Metodo 1: installazione pip (consigliato)

pip install mcp-sora

​
Metodo 2: installazione da sorgente

git clone https://github.com/XHuoAPI/SoraMCP.git
cd SoraMCP
pip install -e .
Dopo l’installazione, puoi avviare il servizio utilizzando il comando mcp-sora.

​
Utilizzo 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": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
Se utilizzi uvx (non è necessario installare pacchetti in anticipo): 
{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
Dopo aver salvato la configurazione, riavvia Claude Desktop per utilizzare gli strumenti Sora nella conversazione.

​
Utilizzo in VS Code / Cursor

Crea .vscode/mcp.json nella directory principale del progetto: 
{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
Oppure utilizza uvx: 
{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}

​
Elenco degli strumenti disponibili

Nome dello strumentoDescrizione
sora_generate_videoGenera video tramite suggerimenti testuali
sora_generate_video_from_imageGenera video basati su immagini
sora_generate_video_with_characterGenera video coerenti utilizzando immagini di riferimento
sora_generate_video_asyncInvia compiti di generazione video in modo asincrono
sora_get_taskConsulta lo stato di un singolo compito
sora_get_tasks_batchConsulta lo stato di più compiti in batch

​
Esempi di utilizzo

Dopo aver completato la configurazione, puoi chiamare queste funzionalità direttamente in linguaggio naturale nel client AI, ad esempio:
  • “Aiutami a generare un video di un gatto che corre sull’erba con Sora”
  • “Genera un video da questa foto di una persona, mantenendo la coerenza del personaggio”
  • “Genera un video verticale, il contenuto è l’alba in città”
  • “Genera un video in modo asincrono e consulta i risultati in seguito”

​
Maggiori informazioni