Sora MCP Integrationsguide

MCP (Model Context Protocol) är en modellkontextprotokoll som lanserats av Anthropic, vilket tillåter AI-modeller (som Claude, GPT etc.) att anropa externa verktyg via standardiserade gränssnitt. Genom Sora MCP Server som tillhandahålls av XHuoAPI kan du direkt använda OpenAI Sora för att generera AI-videor i AI-klienter som Claude Desktop, VS Code, Cursor etc.

Funktionsöversikt

Sora MCP Server erbjuder följande kärnfunktioner:

Textgenererad video — Generera högkvalitativa videor genom textpromptar
Bildgenererad video — Generera video baserat på bilder
Karaktärskonsistensvideo — Bevara karaktärskonsistens med referensbilder
Asynkron generering — Stöd för asynkron uppgiftsinlämning och resultatfrågor
Flera bildriktningar — Stöd för liggande (landscape) och stående (portrait)
Uppgiftsfråga — Övervaka genereringsprocessen och hämta resultat

Förberedelser

Innan användning behöver du skaffa en XHuoAPI API-token:

Registrera dig eller logga in på XHuoAPI-plattformen
Gå till sidan Sora Videos API
Klicka på “Acquire” för att få API-token (första ansökan ger gratis kvot)

Installationskonfiguration

Metod ett: pip-installation (rekommenderas)

pip install mcp-sora

Metod två: källkodinstallation

git clone https://github.com/XHuoAPI/SoraMCP.git
cd SoraMCP
pip install -e .

När installationen är klar kan du använda kommandot mcp-sora för att starta tjänsten.

Använda i Claude Desktop

Redigera konfigurationsfilen för Claude Desktop:

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

Lägg till följande konfiguration:

{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}

Om du använder uvx (ingen förinstallation av paket krävs):

{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}

Spara konfigurationen och starta om Claude Desktop för att använda Sora-relaterade verktyg i dialogen.

Använda i VS Code / Cursor

Skapa .vscode/mcp.json i projektets rotkatalog:

{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}

Eller använd uvx:

{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}

Tillgängliga verktyg

Verktygsnamn	Beskrivning
`sora_generate_video`	Generera video genom textpromptar
`sora_generate_video_from_image`	Generera video baserat på bilder
`sora_generate_video_with_character`	Generera konsistensvideo med referenskaraktär
`sora_generate_video_async`	Asynkront skicka videogenereringsuppgifter
`sora_get_task`	Fråga status för enskild uppgift
`sora_get_tasks_batch`	Batchfråga uppgiftsstatus

Användningsexempel

När konfigurationen är klar kan du direkt använda dessa funktioner med naturligt språk i AI-klienten, till exempel:

“Hjälp mig att generera en video av en katt som springer på gräset med Sora”
“Generera en video med denna personbild, behåll karaktärskonsistensen”
“Generera en stående video med innehållet stads soluppgång”
“Asynkront generera en video och fråga resultatet senare”

Mer information

GitHub-repo: XHuoAPI/SoraMCP
PyPI-paket: mcp-sora
API-dokumentation: Sora videogenererings-API

​Funktionsöversikt

​Förberedelser

​Installationskonfiguration

​Metod ett: pip-installation (rekommenderas)

​Metod två: källkodinstallation

​Använda i Claude Desktop

​Använda i VS Code / Cursor

​Tillgängliga verktyg

​Användningsexempel

​Mer information