TokenHub AIGC Model — MCP Server

El MCP Server invoca la capacidad de generación de imágenes de la plataforma de grandes modelos de TokenHub mediante MCP (Model Context Protocol). El cliente puede configurar su TokenHub API Key en cualquier cliente compatible con MCP (WorkBuddy / Claude Desktop / Cursor / diferentes IDEs de IA) y así llamar directamente en lenguaje natural a las interfaces de texto a imagen, y de imagen a imagen/edición de imágenes.

Modelo actual incorporado como muestra: custom-model-og-v2 (modelo de generación de imágenes de la familia GPT, respuesta síncrona).

Características

• Dos herramientas

  • tokenhub_generate_image: texto a imagen (POST /v1/wand/og-image/generation, respuesta síncrona)

  • tokenhub_edit_image: imagen a imagen/edición de imágenes (POST /v1/wand/og-image/edits, respuesta síncrona, admite 1 a 16 imágenes de entrada y redibujado local con mask)

• Doble transporte

  • stdio (por defecto): conexión directa desde el cliente local, sin despliegue

  • streamable-http: se despliega como endpoint remoto para clientes/equipos externos

• Configuración flexible: API Key, dominio del sitio y nombre del modelo se pueden configurar mediante variables de entorno; cada llamada admite la sobreescritura del dominio/modelo (cambiar de sitio o modelo sin modificar la configuración)

Related MCP server: MCP OpenAI Image Generation Server

Inicio rápido

Método 1: stdio (integración local, recomendado para empezar)

Agrega un MCP Server de tipo comando en la configuración del cliente MCP:

{
  "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"
    }
  }
}

Después de la configuración, puedes conversar directamente: «Dibuja un gatito bailando en un bosque de bambú, 2048x2048».

Método 2: Streamable HTTP (despliegue remoto)

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

Variables de entorno

Dominios del sitio

TokenHub implementa diferentes sitios por región; los clientes de distintos sitios deben completar el dominio correspondiente. El predeterminado es el sitio local de Guangzhou:

Descripción de parámetros de las herramientas

tokenhub_generate_image (texto a imagen)

tokenhub_edit_image (imagen a imagen/edición)

Comparte la mayoría de los parámetros anteriores; y añade:

Resultado: lista de URLs de imágenes, req_id (para rastrear problemas), total_tokens (para facturación); con response_format=b64_json se incluye el bloque de imagen en base64 para mostrar directamente.

Manejo de errores

• Si la llamada a la herramienta falla, se devuelve isError: true; el mensaje de error contiene stat, código de error de la fuente ascendente y request_id.

• Cuando aparezcan errores de permiso / límite de velocidad / parámetro, no olvides conservar el request_id y reportarlo al soporte técnico de TokenHub para localizar el problema.

• Si TOKENHUB_API_KEY no está configurada, la invocación de la herramienta devuelve directamente una respuesta clara (el server puede arrancar sin problema).

Modo HTTP (remoto)

# 本地启动（默认 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

Endpoints:

• POST /mcp, GET /mcp`: entrada del protocolo MCP

• GET /health: comprobación de salud

Al desplegar en la red pública, asegúrate de lo siguiente:

1. Establecer MCP_AUTH_TOKEN, o realizar la autentificación en una pasarela previa/proxy inverso (por ejemplo, EdgeOne, CLB, Nginx);

2. Usar HTTPS;

3. base_url admite sobreescritura por llamada; se recomienda abrirse en entornos confiable.

Desarrollo y publicación

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

Publicar en npmjs (si el registry actual es un espejo de Tencent, debe especificarse explícitamente):

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

⚠️ Recordatorios importantes

1. Lista blanca: custom-model-og-v2 es un modelo de prueba; debes contactar con el equipo de producto/layout de TokenHub para presentar un UIN y AppID para lista blanca antes que puede utilizar lo; si no se usa, la llamada devuelve error de permisos.

2. API Key: por favor, crea una clave exclusiva para el modelo correspondiente en la consola de TokenHub; la key solo se muestra una vez al crearla, guárala correctamente.

3. Facturación: TokenHub se factura según el token (approx 10 yuanes por cada millón de tokens), con liquidación por hora. n>1 o múltiples imágenes de entrada aumentarán significativamente el consumo; pide al departamento comercial que solicite un descuento para el cliente cuanto antes.

4. Fórmula de coste (en RMB): entrada de texto token×3.35 + entrada de texto en caché×0.8375 + entrada de imagen×5.36 + entrada de imagen en caché×1.34 + salida de imagen×20.1 = consumo de token de una sola tarea (el coeficiente está relacionado con el tipo de cambio; el actual es 6.7).

Licencia

Apache-2.0