TokenHub AIGC Model — MCP Server

MCP（Model Context Protocol） を利用して TokenHub 大モデルサービスの画像生成機能を呼び出す MCP Server です。お客様は MCP に対応した任意のクライアント（WorkBuddy / Claude Desktop / Cursor / 各種 AI IDE）で TokenHub API Key を設定するだけで、自然言語でテキストからの画像生成、画像からの画像生成/画像編集インターフェースを直接呼び出すことができます。

現在組み込みのサンプルモデル：custom-model-og-v2（GPT 系の画像生成モデル、同期返却）。

機能特性

• 2つのツール

  • tokenhub_generate_image：テキストから画像生成（POST /v1/wand/og-image/generation、同期返却）

  • tokenhub_edit_image：画像から画像生成/画像編集（POST /v1/wand/og-image/edits、同期返却、1〜16枚の入力画像、マスクによる部分再描画に対応）

• 2つの転送方式

  • stdio（デフォルト）：ローカルクライアントに直接接続、デプロイ不要

  • streamable-http：リモートエンドポイントとしてデプロイし、外部クライアント/チームのリモート接続に対応

• 柔軟な設定：API Key、サイトドメイン、モデル名はいずれも環境変数で設定可能。1回の呼び出しでドメイン/モデルを上書きできます（サイトやモデルの切り替えに設定変更は不要）

Related MCP server: MCP OpenAI Image Generation Server

クイックスタート

方式1：stdio（ローカル接続、まずはこちらを推奨）

MCP クライアントの設定に、コマンドタイプの MCP Server を追加します。

{
  "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」。

方法二：Streamable HTTP（リモートデプロイ）

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

環境変数

サイトドメイン

TokenHub は地域ごとに分散デプロイされています。各サイトのお客様は対応するドメインを入力する必要があります。デフォルトは国内サイトの広州です：

ツールパラメータの説明

tokenhub_generate_image（テキストから画像生成）

tokenhub_edit_image（画像から画像生成/編集）

上記の大部分のパラメータを共有します。追加パラメータは次のとおりです：

戻り値：画像 URL リスト、request_id（問題調査用）、total_tokens（課金用）。response_format=b64_json の場合は 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

エンドポイント：

• POST /mcp、GET /mcp：MCP プロトコルの入口

• GET /health：ヘルスチェック

公網にデプロイする場合は必ず：

1. MCP_AUTH_TOKEN を設定するか、前置ゲートウェイ/リバースプロキシ（例：EdgeOne、CLB、Nginx）で認証を行う；

2. HTTPS を使用する；

3. base_url は1回の呼び出しで上書き可能なため、信頼できる環境でのみ開放することを推奨します。

開発とリリース

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

npmjs に公開する場合（現在の registry が Tencent ミラーの場合は、明示的に指定する必要があります）：

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 はテストモデルのため、TokenHub のプロダクト/バックエンド担当者に連絡し、UIN と Appid を提出してホワイトリスト登録を行ったうえで使用できます。未登録で呼び出すと権限エラーが返ります。

2. API Key：TokenHub コンソール で対応するモデル専用の Key を作成してください。Key は作成時に一度しか表示されないため、確実に保管してください。

3. 課金：TokenHub は Token 単位の課金（約 10 元/百万トークン）で、時間ごとに精算されます。n>1 や複数枚の入力画像では消費が大幅に増えるため、営業担当者はお客様に早めに割引申請を行ってください。

4. 費用計算式（人民元）：テキスト入力 token×3.35 + テキストキャッシュ入力×0.8375 + 画像入力×5.36 + 画像キャッシュ入力×1.34 + 出力画像×20.1 = 1回のタスクの token 消費量（換算係数は為替レートに関係します。現在の係数は 6.7）。

License

Apache-2.0