TokenHub AIGC Model — MCP Server

MCP Server для вызова возможностей генерации изображений платформы больших языковых моделей TokenHub через MCP（Model Context Protocol）. Клиенты могут настроить TokenHub API Key в любом клиенте, поддерживающем MCP (WorkBuddy / Claude Desktop / Cursor / любые AI IDE), и напрямую вызывать интерфейсы «текст-в-изображение» и «изображение-в-изображение / редактирование изображений» на естественном языке.

В настоящее время встроена примерная модель: custom-model-og-v2 (модель генерации изображений семейства GPT, синхронный ответ).

Возможности

• Два инструмента

  • tokenhub_generate_image: «текст-в-изображение»（POST /v1/wand/og-image/generation，синхронный ответ）

  • tokenhub_edit_image: «изображение-в-изображение» / редактирование изображений（POST /v1/wand/og-image/edits，синхронный ответ，поддержка 1–16 входных изображений、локальная перерисовка по маске）

• Два режима передачи

  • stdio（по умолчанию）：локальное подключение клиентов напрямую, нулевое развертывание

  • streamable-http：развертывание в виде удалённой конечной точки для удалённого подключения внешних клиентов/команд

• Гибкая настройка：API Key、домен сайта и имя модели настраиваются через переменные окружения; при отдельном вызове можно переопределить домен/модель（переключение узла или модели без изменения конфигурации）

Related MCP server: MCP OpenAI Image Generation Server

Быстрый старт

Способ 1: stdio（локальное под People, рекомендуется начать с него）

Добавьте MCP Server командного типа в конфигурацию 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"
    }
  }
}

После настройки можно общаться напрямую: «Нарисуй котёнка, танцующего в полосе бамбука, 2048x2048».

Способ 2: Streamable HTTP（удалённое развертывание）

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

Переменные списка

Домены узлов

TokenHub развернут по региональным узлам; клиенты разных узлов должны указывать соответствующий домен. По умолчанию используется внутренний узел (Гуанчжоу):

Описание параметров инструментов

tokenhub_generate_image（текст-в-изображение）

tokenhub_edit_image（изображение-в-изображение/редактирование）

Использует параметры из предыдущего раздела，дополнительно Поддерживается:

Возвращается： скорость list URL изображений、request_id 来排查问题、total_tokens для учёта；при response_format=b64_jsonオ also возвращается блок base64 для прямого просмотра.

Обработка ошибок

• При неуспешном вызове возвращается isError: true, в виз сообщении указывается status, code из вышестоящей ошибки и request_id。

• При ошибках прав/лимитов/параметров сохраните request_id и передавайте его в техническую поддержку TokenHub для диагностики.

• Если TOKENHUB_API_KEY не задан, вызов интерфуда бота возвращает понятное уведомление (нормально запускается)。

Вход HTTP（удалённо）

# 本地启动（默认 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: входная точка протокола MCP

• GET /health: проверка работоспособности

При выкладке в публиную сеть обязательно:

1. Задайте MCP_AUTH_TOKEN or выполните отправку на предварительном шлюзе/в обратном прокси (например, EdgeOne、CLB、Nginx);

2. Используйте HTTPS;

3. base_url поддерживает переопределение при отдельном вызове; рекомендуется открывать только в доверенной средеокружение.

Разработка или публикация

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

Опубликовать в npm Registry（если текущий registry является Новая Verteilung зеркалами, указываете явно）：

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

⚠️ Важные манипуляции

1. Включение в список：custom-model-og-v2 — тестовая модель，для её использования необходимо отправить UIN и Appid в продукт/бэкенд TokenHub для открыты белый знак；бездействующие вызов вернет ошибку права доступа.

2. API Key：создайте специальный key для соответствующеймодели Model in консоль TokenHub. Key показывается только фактически — хранить его надежени.

3. Тарификация：TokenHub оплата по токенам（примерно 10 юаней за 1 млн токенов）——, периодическая детализация。n>1或 several входных图像会让消耗 значительно резко, просьба коммерческому отделу своевременно запросить скидку client.

4. Финансовая формула（юаньки）：текстовый вход токен×3.35 + token×0.8375 кэш ле input + 图片 input×5.36 + 图片 кэш input×1.34 + выходная 图片×20.1 = программный токен消耗（коэффициент пеобразования опирается на курс валют текущий 6.7）。

Лицензия

Apache-2.0