Tanvo

Tanvo MCP

AI 画像・動画・音楽スタジオ Tanvo の MCP サーバーです。アシスタントに「この写真から、うちの猫のルネサンス風肖像画を作って」「この自撮り写真を箱入りのアクションフィギュアにして」「この商品が回転する10秒の動画を作って」「Samへのバースデーソングを作って」と頼むと、Tanvoで実行してファイルを渡してくれます。

Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Cline、Codex、Gemini CLI、その他のMCPクライアントで動作します。試すのにAPIキーは不要です。無料プランでは、Tanvo独自の画像エンジンを利用できます。

できること

• すぐに使える80個のアプリと350種類以上のプリセットスタイル。 ペットの肖像画、フィギュア、古い写真の修復、AIベビー、商品写真、服の試着、トレンド動画（ホテルのロビーでのデュエット、泣き顔フィルター、ダンス）、バースデーソングやラブソングなどがあります。それぞれのスタイルは、実際の出力例付きで調整されたプロンプトなので、どのような結果になるかを事前に確認できます。
• Nano Banana 2 / Pro、Seedream 5、GPT Image 2.5、Qwen Image、Grok Imagine、無料のTanvo独自エンジンによる画像生成：テキストからの画像生成、編集、複数写真の合成に対応しています。
• Veo 3.1、Kling 3.0、Seedance 2.5、Wan、Minimaxなどによる動画生成：テキストからの動画生成、画像からの動画生成、開始・終了フレーム、ネイティブ音声に対応しています。
• Suno V6による楽曲生成：1回の実行につき2種類の楽曲が生成され、それぞれMP3、カバー画像、タイトル、歌詞が付属します。
• ローカルの写真は自動でアップロードされ、結果は指定したフォルダーに直接保存できます。

ツール

ツール	機能
find_apps	ユーザーの希望（「ペットの王族風肖像画」「古い写真を修復」など）からアプリを検索します
get_app	アプリの入力項目とスタイル、出力例、プロンプト、料金を表示します
generate_from_app	ユーザーの写真を使ってアプリのスタイルを実行します
generate_image	テキストから画像を生成するか、写真を編集・合成します
generate_video	テキストまたは画像から動画を生成します（IDを返します。動画の生成には数分かかります）
generate_music	楽曲を作成します。内容を説明する、歌詞を用意する、またはインストゥルメンタルを指定できます
get_generation	実行のステータスと出力を取得します。完了を待ってファイルを保存できます
list_models	すべてのモデル、そのオプション、クレジット料金を表示します
account	無料プランまたはアカウントの情報と、残りのクレジットを表示します
open_in_tanvo	アプリ、スタイル、またはスタジオをすぐに使える状態で開くリンクを表示します

インストール

サーバーはnpxで実行するため、事前のインストールは不要です（Node 20+）。

Claude Code

claude mcp add tanvo -- npx -y tanvo-mcp

アカウントで実行するには、-e TANVO_API_KEY=sk_...を追加します。

Claude Desktop、Cursor、Windsurf、Cline、VS Code（クライアントのMCP設定にあるmcpServersブロック）

{
  "mcpServers": {
    "tanvo": {
      "command": "npx",
      "args": ["-y", "tanvo-mcp"],
      "env": { "TANVO_API_KEY": "sk_..." }
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/tanvoai/tanvo-mcp

Codex（~/.codex/config.toml）

[mcp_servers.tanvo]
command = "npx"
args = ["-y", "tanvo-mcp"]
env = { TANVO_API_KEY = "sk_..." }

サーバーを自動でインストールするAIエージェント（Clineなど）は、llms-install.mdに従ってください。

無料プランとAPIキー

キーを設定しない場合、サーバーはTanvoの匿名無料プランを使用します。利用できるのはTanvo独自の画像エンジン（studio-image-v1）で、透かしが入り、1台あたり1日に数枚までです。それ以外（プレミアムモデルを使うアプリ、動画、楽曲）にはキーが必要です。キーが必要な操作では、ブラウザーで同じアプリまたはプロンプトを開くリンクがサーバーから返されます。新規アカウントには無料クレジットが付与されます。

Settings → API keysでキーを作成してください。キーを使うと自分のアカウントで実行され、モデル、料金、プランはウェブサイトと同じになり、すべての実行結果が履歴に残ります。各実行の料金はget_app / list_modelsで確認でき、失敗した実行の料金は自動的に返金されます。

変数	説明
TANVO_API_KEY	APIキー（任意）
TANVO_OUTPUT_DIR	すべての結果をこのフォルダーに保存します（任意。各呼び出しでsave_toを指定することもできます）
TANVO_BASE_URL	別のデプロイ先（例：ローカルビルド。既定値はhttps://tanvo.ai）
TANVO_ANON_ID	~/.config/tanvo-mcp/anon-idに保存されたIDの代わりに、無料プランのIDを固定します

使用例

愛犬をルネサンス期の油絵のようにしてください。~/Pictures/rex.jpg

find_apps → get_app ai-pet-portrait-generator → look に renaissance を指定し、写真とともに generate_from_app を実行します。

サーフィンとひどいダジャレが大好きな妹の Ana に、誕生日ソングを書いてください。~/Music に保存してください。

Describe モードで generate_music を実行し、save_to: "~/Music" を指定します。

この商品写真を、ゆっくりと360°回転するアニメーションにしてください。9:16。

find_apps "product spin" → generate_from_app product-spin を実行し、完了するまで get_generation を呼び出します。

プライバシー

ジョブを実行するため、渡されたプロンプトと写真は プライバシーポリシー に基づいて tanvo.ai に送信されます。処理が実行される前に、コンテンツのモデレーションが行われます。サーバーには匿名の無料プラン ID 以外は保存されません。

開発

npm install
npm run build
TANVO_BASE_URL=http://localhost:3210 node dist/index.js

ドキュメント：tanvo.ai/developers/mcp · API リファレンス：tanvo.ai/developers/api · OpenAPI：tanvo.ai/openapi.yaml

Tanvo のその他のプロジェクト

• tanvo-python：pip install tanvo
• tanvo-js：npm install @tanvoai/sdk

ライセンス

MIT