TokenHub AIGC Model — MCP Server

Ein MCP Server, der über MCP (Model Context Protocol) die Bildgenerierungsfunktionen der TokenHub-LLM-Serviceplattform aufruft. Kunden können in jedem MCP-fähigen Client (WorkBuddy / Claude Desktop / Cursor / beliebigen KI-IDEs) den TokenHub-API-Schlüssel konfigurieren und direkt per natürlicher Sprache Text-zu-Bild-, Bild-zu-Bild-/Bildbearbeitungsschnittstellen aufrufen.

Derzeit integriertes Beispielmodell: custom-model-og-v2 (GPT-basiertes Bildgenerierungsmodell, synchron zurückgegeben).

Funktionsmerkmale

• Zwei Werkzeuge

  • tokenhub_generate_image: Text-zu-Bild (POST /v1/wand/og-image/generation, synchron)

  • tokenhub_edit_image: Bild-zu-Bild/Bildbearbeitung (POST /v1/wand/og-image/edits, synchron, unterstützt 1–16 Eingabebilder, Masken-Inpainting)

• Zwei Transportarten

  • stdio (Standard): direkte Anbindung für lokale Clients, keine Bereitstellung erforderlich

  • streamable-http: als Remote-Endpunkt bereitstellen, für externe Kunden/Teams per Fernzugriff

• Flexible Konfiguration: API-Key, Standort-Domain und Modellname sind über Umgebungsvariablen konfigurierbar; Domain/Modell können pro Aufruf überschrieben werden (Standort- oder Modellwechsel ohne Konfigurationsänderung)

Related MCP server: MCP OpenAI Image Generation Server

Schnellstart

Methode 1: stdio (lokale Anbindung, zuerst empfohlen)

Fügen Sie in der MCP-Client-Konfiguration einen MCP Server vom Typ „Befehl“ hinzu:

{
  "mcpServers": {
    "tokenhub": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tokenhub-aigc-model"],
      "env": {
        "TOKENHUB_API_KEY": "你的 TokenHub API Key",
        "TOKENHUB_BASE_URL": "https://tokenhub.tencentmaas.com",
        "TOKENHUB_MODEL": "custom-model-og-v2"
      },
      "description": "TokenHub 生图 MCP"
    }
  }
}

Nach der Konfiguration kann direkt gechattet werden: „Zeichne mir ein Kätzchen, das in einem Bambuswald tanzt, 2048x2048“.

Methode 2: Streamable HTTP (Remote-Bereitstellung)

{
  "mcpServers": {
    "tokenhub": {
      "url": "https://你的服务域名/mcp",
      "headers": { "x-mcp-auth-token": "部署时设置的 MCP_AUTH_TOKEN" }
    }
  }
}

Umgebungsvariablen

Standort-Domains

TokenHub wird nach Regionen bereitgestellt; Kunden an verschiedenen Standorten müssen die entsprechende Domain angeben. Standard ist der Standort Guangzhou des Inland:

Tool-Parameterbeschreibung

tokenhub_generate_image (Text-zu-Bild)

tokenhub_edit_image (Bild-zu-Bild/Bearbeitung)

Teilt die meisten Parameter oben, zusätzlich:

Rückgabe: Liste der Bild-URLs, request_id (zur Problembehebung), total_tokens (zur Abrechnung); bei response_format=b64_json zusätzlich Base64-Bilddaten zur direkten Anzeige.

Fehlerbehandlung

• Fehlgeschlagene Tool-Aufrufe geben isError: true zurück; die Fehlerinformationen enthalten status, den code des Upstream-Fehlers und request_id.

• Bei Berechtigungs-, Limitierungs- oder Parameter-Fehlern: bewahren Sie die request_id auf und reichen Sie sie beim TokenHub-Support zur Analyse ein.

• Wenn TOKENHUB_API_KEY nicht konfiguriert ist, liefert der Tool-Aufruf direkt einen eindeutigen Hinweis zurück (der Server startet dennoch normal).

HTTP-Modus-Bereitstellung (Remote)

# 本地启动（默认 stdio）
npx -y tokenhub-aigc-model

# HTTP 模式
TOKENHUB_API_KEY=xxx MCP_AUTH_TOKEN=部署密钥 \
  npx -y tokenhub-aigc-model --transport=http --port=3000 --host=127.0.0.1

Endpunkte:

• POST /mcp, GET /mcp: MCP-Protokoll-Einstieg

• GET /health: Health-Check

Bei öffentlicher Bereitstellung unbedingt:

1. MCP_AUTH_TOKEN setzen oder in einem vorgelagerten Gateway/Reversen Proxy (z. B. EdgeOne, CLB, Nginx) authentifizieren.

2. HTTPS verwenden.

3. base_url unterstützt „überschreiben beim einzelnen Aufruf“, sollte aber nur in vertrauenswürdigen Umgebungen freigeschaltet werden.

Entwicklung und Veröffentlichung

npm install        # 安装依赖
npm run build      # TypeScript 构建到 dist/
npm test           # 单元测试 + stdio/HTTP 冒烟测试（共 20 个用例）
npm pack --dry-run # 查看发布内容

Veröffentlichung an npmjs Ohne (bei Tencent-Registry, wenn aktiv, muss es explizit angegeben werden):

npm run build
npm version patch
npm publish --access public --registry=https://registry.npmjs.org
git tag v0.1.0 && git push --tags

⚠️ Wichtige Hinweise

1. Freigabe: custom-model-og-v2 ist ein Testmodell. Reichen Sie über den TokenHub-Produkt bzw. Technikmitarbeiter eine Freigabe auf Basis von UIN und Appid ein; ohne Freigabe liefern Aufrufe einen Berechtigungsfehler.

2. API-Key: Erstellen Sie für das entsprechende Modell in der TokenHub-Konsole einen eigenen Key. Der Key wird nur einmal bei Erstellung angezeigt, bewahren Sie ihn sicher auf.

3. Abrechnung: TokenHub abrechnet nach Token (ca. 10 RMB/1 Million Tokens), stündliche Verrechnung. n>1 oder mehrere Eingabebilder erhöhen den Verbrauch deutlich; lassen Sie den Vertrieb rechtzeitig für Discount für Kunden beantragen – beachten Sie.

4. Kostenformel (RMB): Text-Eingabe-Token × 3.35 + Text-Cache-Token × 0.8375 + Bild-Eingabe-Token × 5.36 + Bild-Cache-Token × 1.34 + Ausgabe-Bild-Token × 20.1 = Token-Verbrauch für eine einzelne Aufgabe (Umwandlungsfaktor hängt vom Wechselkurs ab, derzeit Faktor 6.7).

Lizenz

Apache-2.0