avots

avots-mcp

avots.ai の公式 MCP（Model Context Protocol）サーバーです。複数プロバイダーに対応した AI プラットフォームです。

1 つの接続で、次の機能を利用できます。

• 🖼 画像の生成と編集 - Nano Banana（Gemini 3 Pro / 3.1 Flash）、GPT-5 Image、FLUX、Recraft（ネイティブのベクター SVG に対応）、Ideogram
• 🎬 動画の生成と編集 - Veo 3.1、Seedance 2.0、Kling v3.0 Pro、Sora 2 Pro、Grok Imagine、Gemini Omni Flash（非同期、1〜8 分）。さらに、既存クリップのシーン編集、顔の入れ替え、リボイスによるリップシンクにも対応します
• 🧑‍🎤 トーキングヘッドとアバター - 保存して再利用できる顔の ID、トーキングアバター動画、Shorts / TikTok 向けの縦型 AI Vlog
• 🎵 音楽と音声 - ElevenLabs Music、ACE-Step、Stable Audio、TTS ナレーション（音声のクローンに対応）
• 🎨 スタジオテンプレート - 写真モンタージュのリール、ビンテージ旅行ポスター、自分の顔を使ったバイラルトレンドの再現
• 💬 300 以上のチャットモデル - Claude（Sonnet / Opus）、GPT-5、Gemini 3、DeepSeek、Sonar など。1 つの残高でまとめて支払えます

サーバーは https://mcp.avots.ai/ にあり、Streamable HTTP 経由で MCP 2025-06-18 仕様 に準拠しています。ツールの料金は、呼び出しごとに avots の残高から差し引かれます（ウェブアプリや Telegram ボットで確認できる残高と共通です）。

クイックスタート

1. avots.ai に登録し、Settings → Integrations で MCP キーを発行します（av_mcp_<48hex> の形式です）。
2. 以下の表からクライアントを選び、リンク先のガイドに従います。
3. 試してみましょう - クライアントに 「雪の森にいるキツネの画像を生成して」 と依頼し、トークンが消費されるのを確認します。

クライアント	ガイド	認証方式
Claude.ai web	docs/claude-web.md	OAuth - URL を貼り付けて［Connect］をクリックし、サインインします（トークンのコピー＆ペーストは不要です）
Claude Desktop	docs/claude-desktop.md	mcp-remote 経由のベアラートークン
Claude Code (CLI)	docs/claude-code.md	claude mcp add 経由のベアラートークン
Cursor	docs/cursor.md	mcp-remote 経由のベアラートークン
Cline	docs/cline.md	mcp-remote 経由のベアラートークン
その他の MCP クライアント	docs/tools.md - エンドポイントとツール一覧	ベアラーヘッダー Authorization: Bearer av_mcp_…

すぐに貼り付けて使える mcp.json のスニペットは、examples/ にあります。

サーバーに含まれるもの

19 個のツールがあり、すべて docs/tools.md に記載されています。

ツール	コスト	機能
check_balance	無料	現在のトークン数、サブスクリプションのティア、料金カタログ全体を確認します。
list_models	無料	アクティブなモデルと呼び出しごとのコストをすべて表示します（chat、image、video、audio で絞り込めます）。
list_avatars	無料	ユーザーが保存した、再利用可能な顔の ID を表示します。
list_trends	無料	avots Studio のバイラルテンプレートのカタログを表示します（顔入れ替え動画、広告、アニメーション）。
check_job	無料	job_id を指定して、任意の非同期ジョブの状態を確認します。
chat	約 10-1000 ⚡	任意のチャットモデルにプロンプトを送信します。GPT、DeepSeek、Sonar などへの委任に便利です。
generate_image	約 200-500 ⚡	同期画像生成と写真編集（image_urls）に対応します。Recraft はネイティブのベクター SVG（format: "svg"、2x）を返せます。
generate_video	約 200-5000 ⚡	2 段階確認に対応した非同期動画生成です。i2v、複数写真によるキャラクター参照、モーション参照クリップをサポートします。
face_swap_video	約 500-2000 ⚡	既存の動画内の顔を写真（または保存済みアバター）の顔と入れ替えます。2 段階確認です。
edit_video	約 450 ⚡/秒	テキストプロンプトで既存のクリップのシーンを編集します。人物、動き、元の音声は保持されます。2 段階確認です。
lipsync_video	約 300-600 ⚡	話している人物が映る既存動画の音声を差し替えます。新しいテキスト（TTS）または用意済みの音声トラックを使えます。2 段階確認です。
create_avatar	無料 / 約 200-500 ⚡	写真から再利用可能な顔の ID を保存するか（無料）、説明から生成します。
generate_talking_avatar	約 600-2500 ⚡	ポートレートの人物に指定したテキストを話させます。TTS とリップシンクに対応し、品質重視／高速のティアを選べます。2 段階確認です。
generate_vlog	プレビューに価格を表示	Shorts / TikTok 向けの縦型 AI インフルエンサー動画です。トピックをもとにサーバーがセリフを作成します。2 段階確認です。
generate_audio	約 50-800 ⚡	音楽（ElevenLabs Music、ACE-Step、Stable Audio）またはクローン音声を含む TTS ナレーションを生成します。非同期です。
create_montage	約 200 ⚡	4〜25 枚の写真から、Ken Burns 効果、クロスフェード、音楽付きのスライドショー動画を作成します。
create_travel_poster	約 200-500 ⚡	顔写真から、任意の国を題材にしたビンテージ旅行ポスターを作成します。同期処理です。
recreate_trend	トレンドごと	list_trends のバイラルテンプレートにユーザーの顔を入れます。
create_calendar_event	約 5 ⚡	自然言語から、リンク済みの Apple/Google カレンダーに予定を追加します（または .ics ファイルをダウンロードします）。

動画の 2 段階フローについて。 動画は最もコストの高いツールです。予想外の出費を防ぐため、初回の generate_video 呼び出しではプレビューカードが返されます（送信も予約も行われません）。クライアント（例：Claude）は料金と価格付きの代替モデルを表示し、ユーザーに確認を求めます。ユーザーが確認すると、クライアントは選択した model と confirmed: true を指定して再度呼び出し、その後にのみジョブが送信されます。送信エラー時には、サーバーは同じ代替モデルのカードを返します。より高額なモデルに無断で切り替えることはありません。

作成できるもの

実際に役立つ使い方をいくつか紹介します。どれも 1 つの接続と 1 つの残高を使い、2 つ以上のツールを連携させます。

• 1 つのプロンプトからソーシャル広告素材を作成 — メイン画像、アニメーション版、BGM。
• 商品写真のアングルセットを作成 — 商品写真 1 枚から、4 つのアングルと回転動画を作成。
• ストーリーボードからアニマティックを作成 — スクリプトに沿った 4 枚のフレームをアニメーション化し、12 秒のラフカットに仕上げます。
• 縦型 Reels / Shorts を量産 — 9:16 の動画と、それに合った 15 秒の音楽を動画ごとに繰り返し作成。
• ポッドキャストのカバーアートと番組ノートを作成 — カバーのバリエーションを 4 つと、それぞれのエピソード説明文を作成。
• 別のモデルにセカンドオピニオンを依頼 — 難しい問題を異なる系統のモデルに送り、回答を比較します。
• ローカライズされたブランド素材を作成 — 市場ごとにコピーを翻訳し、地域に合わせたビジュアルを作成します。

各フローは、実行可能なスクリプトとして docs/recipes.md に記載されています。正確なプロンプト、ツールの実行順序、モデルの選択、コストを確認できます。

コストは単一画像の約 200⚡ から、10 秒の 1080p Kling Pro クリップの約 5000⚡ まで幅があります。いつでも list_models（無料）を実行して、呼び出しごとの最新料金を確認できます。

料金

すべてのツール呼び出しは、ウェブアプリやTelegramボットと同様に、avotsの残高から差し引かれます。別途の従量課金はありません。1日のUSD上限（Settingsで設定）とキーごとのレート制限が適用されます。

トークンパックとサブスクリプションについては、pricing.avots.aiをご覧ください。

トラブルシューティング

クライアント間でよく発生する問題（401エラー、1日の上限、動画の2段階処理、画像のレンダリング、npxのPATHに関する注意点）をdocs/troubleshooting.mdにまとめています。クライアント固有のセットアップについては、上記の表にある各クライアントのガイドをご覧ください。

問題とフィードバック

こちらでIssueを作成するか、[email protected]までご連絡ください。プラットフォームに関する質問（料金、モデル、ウェブアプリ）には、Telegramボットの@AvotsAIbotが最も迅速な窓口です。

ライセンス

MIT — ドキュメントやサンプルなど、ここにあるものは自由にフォークしてください。