GenMagic

GenMagic MCP サーバー

Model Context Protocol サーバーひとつで、あらゆる AI エージェントがテキスト、画像、音声、音楽、動画を生成できます。料金は、ひとつの前払いクレジット残高から差し引かれます。

GenMagic は、あらゆる生成 AI モデルをあらゆるメディアで利用できる、ひとつのスタジオであり、ひとつの API です。このリポジトリは、GenMagic のリモート MCP サーバーへの接続ガイドとレジストリ記述子です。あらゆる MCP クライアントからひとつの URL に接続してキーを設定すれば、エージェントは 6 つの生成ツールと list_models を利用できます。GenMagic の 450 以上のモデル（GPT、Claude、Gemini、Veo、Kling、Seedance、FLUX、Recraft など）から ID で選ぶことも、選択を GenMagic に任せることもできます。

• エンドポイント： https://genmagic.co/api/mcp
• トランスポート： Streamable HTTP（ステートレス JSON-RPC）
• バージョン： 1.1.1
• 認証： Authorization: Bearer gm_live_...（キーは https://genmagic.co/get-api-key で作成）
• ホスティング： インストールも実行も不要です。稼働中のリモートサーバーです。
• レジストリ： io.github.yumaheymans/genmagic として Official MCP Registry に登録されています（server.json を参照）。

ツール

ツール	機能
list_models	最新のモデルカタログです。各モデルの ID、価格、主な詳細（コンテキストウィンドウ、テキスト生成機能、音声生成の音声、動画の解像度、クリップの長さ、サウンドなど）を確認できます。category、search、capability で絞り込めます。キーは不要です。
generate_text	テキスト、コード、SVG グラフィック、またはウェブページ全体を生成します（type と model は任意）。
generate_image	画像を生成または編集します。ブランドマークには type=logo を指定します。model は任意です。
generate_speech	テキストをそのまま読み上げた音声に変換します。model と voice は任意です。
generate_music	説明に基づいてオリジナルの音楽トラックを生成します。model は任意です。
create_video	対応する任意のテキスト動画生成モデルを使い、duration、resolution、generate_audio を指定して非同期の動画ジョブを開始します（ジョブ ID が返され、この時点では課金されません）。
get_video	動画ジョブの状態を確認します。完了時に一度だけ課金されます。

各生成ツールでは、list_models にある model ID を任意で指定できます。指定した種類の出力に対応していないモデル ID は、別のモデルに置き換えられることなく、list_models への案内とともに拒否されます。model を省略すると、GenMagic が価格を考慮して適切なデフォルトモデルを選びます。

initialize、ping、tools/list、list_models は公開されており、生成ツールにはキーが必要です。各ツールの結果には、MCP の _meta キー genmagic.ai/usage の下に利用状況が記載されます（実行された model、cost_cents、credits_remaining、rate オブジェクト）。これにより、エージェントは結果から利用ペースを調整し、予算を追跡できます。

接続

https://genmagic.co/get-api-key でキーを作成し（無料で登録して、メールアドレスを認証してください）、クライアントにサーバーを追加します。

Claude Code

claude mcp add --transport http genmagic https://genmagic.co/api/mcp \
  --header "Authorization: Bearer gm_live_your_key"

VS Code

ワンクリックでインストールするには、https://genmagic.co/developers#mcp を開き、Add to VS Code を選択します。VS Code がキーを一度だけ尋ね、シークレットとして保存します。または、.vscode/mcp.json に手動で追加します。

{
  "inputs": [
    { "type": "promptString", "id": "genmagic-api-key", "description": "GenMagic API key", "password": true }
  ],
  "servers": {
    "genmagic": {
      "type": "http",
      "url": "https://genmagic.co/api/mcp",
      "headers": { "Authorization": "Bearer ${input:genmagic-api-key}" }
    }
  }
}

Cursor、Windsurf、およびほとんどのクライアント

MCP 設定（.cursor/mcp.json またはクライアントに相当する設定ファイル）に genmagic エントリを追加します。Cursor では、https://genmagic.co/developers#mcp からワンクリックで Add to Cursor を選ぶこともできます。

{
  "mcpServers": {
    "genmagic": {
      "url": "https://genmagic.co/api/mcp",
      "headers": { "Authorization": "Bearer gm_live_your_key" }
    }
  }
}

Claude Desktop

Settings → Connectors でカスタムコネクタとして GenMagic を追加し、URL に https://genmagic.co/api/mcp、ヘッダーに Authorization: Bearer gm_live_your_key を指定します。

任意の JSON-RPC クライアント（直接利用）

サーバーは HTTP 経由のプレーンな JSON-RPC なので、curl で呼び出せます。

# List the tools (no key required)
curl https://genmagic.co/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

# Generate an image (key required)
curl https://genmagic.co/api/mcp \
  -H "Authorization: Bearer gm_live_your_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 2, "method": "tools/call",
    "params": {
      "name": "generate_image",
      "arguments": { "prompt": "a cobalt prism refracting into a spectrum, dark studio, 3D render", "size": "1024x1024" }
    }
  }'

課金の仕組み

エージェント専用の課金メーターはありません。スタジオ、REST API、またはこの MCP サーバーからのすべての生成で、基盤モデルの実際のプロバイダー料金が、1 つの米ドル建てプリペイド残高から差し引かれます（1 クレジット＝1 米セント）。メール認証後、新規アカウントには一度限りの 0.50 ドル分の初回残高が付与されます（1 人につき 1 回）。5 ドルから 100 ドル単位でチャージするか、購読者ボーナスと商用利用権が付いた、残高が自動更新されるサブスクリプションに登録してください。create_video と、動画をまだレンダリング中の get_video のポーリングには料金がかかりません。クリップの料金は、処理が完了するポーリング時に発生します。詳しくは https://genmagic.co/pricing をご覧ください。

ブランドに合わせた生成

アプリで一度 パーソナライズ を有効にすると（ウェブサイトまたは LinkedIn を接続します）、プロンプトを変更しなくても、すべてのツール呼び出しの結果がブランドのトーン、オーディエンス、カラーに合わせて調整されます。視覚的なツールの結果には、ブランドの配色から外れていないかを読み取って返す brand_fit も含まれ、エージェントは必要に応じて再生成できます。

リンク

• スタジオ：https://genmagic.co · API キー：https://genmagic.co/get-api-key
• API と MCP のドキュメント全文：https://genmagic.co/developers
• 機械可読な情報：/.well-known/mcp.json · /llms.txt · /openapi.json
• 料金：https://genmagic.co/pricing

ライセンス

MIT です。LICENSE をご覧ください。このリポジトリには接続に関するドキュメントとレジストリ記述子が含まれます。GenMagic サービス自体は genmagic.co で運営されています。