Przejdź do głównej treści

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) to protokół kontekstowy modeli opracowany przez Anthropic, który pozwala modelom AI (takim jak Claude, GPT itp.) na wywoływanie zewnętrznych narzędzi za pomocą ustandaryzowanego interfejsu. Dzięki Seedream MCP Server dostarczanemu przez XHuoAPI możesz bezpośrednio korzystać z generowania i edycji obrazów AI Seedream ByteDance w klientach AI takich jak Claude Desktop, VS Code, Cursor i innych.

​
Przegląd funkcji

Seedream MCP Server oferuje następujące kluczowe funkcje:
  • Generowanie obrazów z tekstu — tworzenie wysokiej jakości obrazów na podstawie tekstowych promptów (wspiera prompt w języku chińskim i angielskim)
  • Edycja obrazów — modyfikacja stylu, tła, właściwości istniejących obrazów
  • Wirtualna przymiarka ubrań — nakładanie ubrań na zdjęcia osób
  • Wsparcie wielu modeli — obsługa Seedream v4.5, v4.0, v3.0 T2I, SeedEdit v3.0 I2I i innych modeli
  • Różne rozdzielczości — wsparcie rozdzielczości 1K, 2K, 4K oraz adaptacyjnej
  • Kontrola ziarna (seed) — możliwość odtworzenia wyników generowania za pomocą parametru seed
  • Zapytania o zadania — monitorowanie postępu generowania i pobieranie wyników

​
Wymagania wstępne

Przed użyciem musisz uzyskać XHuoAPI API Token:
  1. Zarejestruj się lub zaloguj na XHuoAPI Platform
  2. Przejdź do strony Seedream Images API
  3. Kliknij „Acquire”, aby uzyskać API Token (pierwsza rejestracja daje darmowy limit)

​
Instalacja i konfiguracja

​
Metoda 1: instalacja przez pip (zalecane)

pip install mcp-seedream-pro

​
Metoda 2: instalacja ze źródła

git clone https://github.com/XHuoAPI/SeedreamMCP.git
cd SeedreamMCP
pip install -e .
Po instalacji możesz uruchomić serwer poleceniem mcp-seedream-pro.

​
Użycie w Claude Desktop

Edytuj plik konfiguracyjny Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Dodaj następującą konfigurację: 
{
  "mcpServers": {
    "seedream": {
      "command": "mcp-seedream-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}
Jeśli używasz uvx (nie wymaga wcześniejszej instalacji pakietów): 
{
  "mcpServers": {
    "seedream": {
      "command": "uvx",
      "args": ["mcp-seedream-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}
Po zapisaniu konfiguracji i ponownym uruchomieniu Claude Desktop możesz korzystać z narzędzi Seedream w rozmowach.

​
Użycie w VS Code / Cursor

W katalogu głównym projektu utwórz plik .vscode/mcp.json: 
{
  "servers": {
    "seedream": {
      "command": "mcp-seedream-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}
Lub użyj uvx: 
{
  "servers": {
    "seedream": {
      "command": "uvx",
      "args": ["mcp-seedream-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}

​
Lista dostępnych narzędzi

Nazwa narzędziaOpis
seedream_generate_imageGenerowanie obrazu z tekstowego promptu
seedream_edit_imageEdycja lub modyfikacja istniejącego obrazu
seedream_get_taskZapytanie o status pojedynczego zadania
seedream_get_tasks_batchMasowe zapytanie o statusy zadań
seedream_list_modelsLista dostępnych modeli i ich możliwości
seedream_list_sizesLista dostępnych rozmiarów i opcji rozdzielczości obrazów

​
Przykłady użycia

Po konfiguracji możesz bezpośrednio wywoływać funkcje za pomocą naturalnego języka w kliencie AI, na przykład:
  • „Pomóż mi wygenerować obraz krajobrazu w stylu tuszu za pomocą Seedream”
  • „Zmień tło tego zdjęcia na gwiaździste niebo”
  • „Wygeneruj portret 4K w wysokiej rozdzielczości Seedream v4.5”
  • „Nałóż wirtualnie tę odzież na to zdjęcie”

​
Więcej informacji