Chutes Media MCP

Chutes Media MCP

任意のコーディングエージェントから Chutes 経由で画像、動画、音楽、音声を生成し、アセットを作業中のプロジェクトに直接保存できます。

Chutes Media MCP は、コーディングエージェントに Chutes のメディアモデルへのアクセスを提供する Model Context Protocol（MCP）サーバー兼コマンドラインインターフェース（CLI）です。標準入出力（stdio）を使う MCP サーバー、MCP に対応していないエージェント向けの軽量 CLI、そして「説明してから生成する」ワークフロー用のバンドル済み Agent Skill として提供されます。

モデルごとにペイロードをハードコードする代わりに、サーバーはモデルのライブスキーマを取得し、GPU 呼び出しを行う前にリクエストを検証してから、アセットとその来歴レコードをワークスペースに書き込みます。Claude Code、Cursor、Cline、Windsurf、Codex、OpenCode、Claude Desktop で動作します。

これは独立したコミュニティプロジェクトです。Chutes との提携、スポンサー関係、または承認を受けていません。

インストール

グローバルにインストールせずに、npm からサーバーを実行します。

npx -y chutes-media-mcp

両方のバイナリを PATH に追加するには、グローバルにインストールします。

npm install -g chutes-media-mcp

サーバーを Claude Code に登録します。

claude mcp add chutes-media --env CHUTES_API_KEY=cpk_your_key -- npx -y chutes-media-mcp

Cursor、Cline、Windsurf、OpenCode、Claude Desktop では、docs/mcp-and-cli.md に記載されている mcpServers エントリーを追加します。npm の代わりに GitHub から実行することもでき、その場合は npx -y github:TheStreamCode/chutes-media-mcp を使います。1.x からアップグレードしますか？docs/migration-2.0.md をご覧ください。

クイックスタート

1. chutes.ai で Chutes API キーを作成し、「インストール」の手順に従ってサーバーを登録します。
2. エージェントにアセットの生成を依頼します：「霧に包まれた山並みを描いた映画のようなヒーロー画像を生成し、このプロジェクトに保存してください。」
3. エージェントが適切なモデルを見つけ、ライブスキーマを読み取り、ペイロードを検証して、結果を assets/chutes/image/ に保存します。返されたパスはコードからそのまま参照できます。

同じ「説明してから生成する」フローは、シェルから chutes-media CLI を使って実行できます。ツールリファレンス、CLI の例、画像編集については、docs/mcp-and-cli.md をご覧ください。

機能

• 4 種類のメディア（画像、動画、音楽、音声）に対応し、モデルが img2img や inpaint などの編集用コルドを公開している場合は画像編集も可能です。
• ライブなモデル仕様：コルドと入力スキーマは実行時に取得され、ハードコードされません。
• GPU 呼び出しの前に、ライブスキーマに照らしてペイロードを検証します。
• ワークスペース内に限定したファイルアクセス。overwrite が明示的に設定されない限り、既存のアセットは保持されます。
• 各アセットに、モデル、コルド、パラメーター、スキーマハッシュを記録した来歴サイドカーを作成します。
• スケール・トゥ・ゼロに対応したモデル向けに、バックオフ付きのコールドスタート再試行を自動で行います。
• 時間のかかる動画や音楽のジョブに進捗を通知します。
• コアを共有するため、MCP サーバーと CLI は同じ動作をします。

要件

• 公開済みサーバーと CLI には Node.js 20.3 以降が必要です。Node.js 20 はサポート終了のため、本番環境では Node.js 22 または 24 LTS を使用してください。
• Chutes API キー。
• 固定されたツールチェーンを使うコントリビューターには、Node.js ^20.19.0、>= 22.13.0、または >= 24 が必要です。

設定

変数	必須	デフォルト	用途
CHUTES_API_KEY	はい	なし	Chutes API キーです。環境変数から読み取られ、ディスクには書き込まれません。
CHUTES_AUTH_SCHEME	いいえ	raw	Authorization でキーを送信する方法です。raw（キーをそのまま送信）または bearer（値の前に Bearer とスペースを付加）を指定します。401 が返された場合は、もう一方の値を試してください。
CHUTES_API_BASE_URL	いいえ	https://api.chutes.ai	管理 API のベース URL です。ループバック環境での開発を除き、HTTPS が必須です。カスタムエンドポイントに Chutes API キーが送信されることはありません。
CHUTES_OUTPUT_DIR	いいえ	assets/chutes	エージェントの作業ディレクトリ内にある出力ディレクトリです。末尾に <kind>/ サブフォルダーが追加されます。
CHUTES_WARMUP	いいえ	true	モデルを呼び出す前にウォームアップします。ウォームアップを省略するには false に設定します。
CHUTES_COLD_START_RETRIES	いいえ	4	コールド状態のモデルが 503 no-instances を返した場合の再試行回数です。再試行を無効にするには 0 に設定します。
CHUTES_COLD_START_BACKOFF_MS	いいえ	8000	コールドスタート時の再試行間隔の基本値です。試行ごとに間隔が長くなります。
CHUTES_MAX_ASSET_MB	いいえ	512	メモリに保持するレスポンスまたはローカル入力アセットの最大サイズです。最大値は 4096 です。
CHUTES_PROGRESS_INTERVAL_MS	いいえ	5000	呼び出しがブロックしている間に、進行状況のハートビートを送信する間隔です。
CHUTES_ALLOW_UNKNOWN_PARAMS	いいえ	false	true の場合、モデルスキーマにないパラメーターを受け入れます。デフォルトでは拒否されるため、フィールド名が変更されている場合はエラーが明確に通知されます。
CHUTES_PROVENANCE	いいえ	true	モデル、cord、パラメーター、スキーマハッシュを含む <asset>.json サイドカーファイルを書き込みます。無効にするには false に設定します。

生成されたアセットは、エージェントの実行場所を基準とする ./assets/chutes/<kind>/ 以下に保存されるため、プロジェクト内に配置されます。出力パスのディレクトリ遡及やシンボリックリンクによる逸脱は拒否され、上書きが有効になっていない限り既存のファイルは保持されます。

プライバシーとセキュリティ

API キーは CHUTES_API_KEY から読み取られ、メモリ内に保持されます。認証情報を含むリクエストは HTTPS の Chutes ホストにのみ送信され、リモートアセットの URL はプライベートネットワーク宛てでないか検査されます。また、ファイルアクセスはワークスペース内に制限されます。ネットワークエラーメッセージからクエリ文字列とフラグメントが削除されるため、署名付きアセット URL がログに残ることはありません。このプロジェクトはテレメトリーを収集しません。報告については SECURITY.md を参照してください。

トラブルシューティング

Chutes リクエストが 401 を返す

キーが未設定、無効、または誤った認証方式で送信されています。サーバーを起動するプロセスに CHUTES_API_KEY が設定されていることを確認し、現在の値とは異なる方の bearer または raw を CHUTES_AUTH_SCHEME に設定してください。

モデルが 503 no-instances を返す場合

モデルがゼロまでスケールダウンされており、Chutes に利用可能なインスタンスがありません。サーバーは自動的に再試行します。 待ち時間が長すぎる場合は CHUTES_COLD_START_RETRIES と CHUTES_COLD_START_BACKOFF_MS の値を増やすか、 同じ種類の別のモデルを選択してください。

生成が不明なパラメーターまたは拒否されたパラメーターで失敗する場合

稼働中のモデルのスキーマが変更されたか、パラメーター名が誤っています。describe_media_model を再度呼び出し、 現在のスキーマに基づいてペイロードを作り直してください。CHUTES_ALLOW_UNKNOWN_PARAMS=true は一時的な 回避策であり、修正ではありません。

アセットの書き込みが拒否される場合

入力パスと出力パスはすべて現在のワークスペース内に解決される必要があり、既存のファイルが暗黙に置き換えられることはありません。対象パスを確認してから、明示的に overwrite オプション（CLI では --overwrite）を指定してください。

開発

要件：Node.js ^20.19.0、>= 22.13.0、または npm を含む >= 24。

git clone https://github.com/TheStreamCode/chutes-media-mcp
cd chutes-media-mcp
npm ci
npm run check

npm run check は、フォーマットチェック、Lint、型チェック、カバレッジテスト、ビルドを実行します。 CONTRIBUTING.md では、Windows のパスに関する注意点と、オプトイン方式のライブテストについて説明しています。

サポート

使い方に関する質問は GitHub Discussions で、 再現可能な不具合は GitHub Issues で報告してください。 脆弱性は SECURITY.md の説明に従って、非公開で報告してください。

コントリビューション

CONTRIBUTING.md を参照してください。プルリクエストは必須の CI チェックに合格する必要があります。

ライセンス

MIT — LICENSE を参照してください。サードパーティに関する通知は NOTICE にあります。

---

Michael Gasperini (Mikesoft) がメンテナンスしています。 このプロジェクトが役に立った場合は、メンテナンスへのスポンサーをご検討ください。