Medux について
Medux は、AI アシスタントからメディアを生成・編集するホスト型 MCP サーバーです。動画、画像、音声、ボイスクローン、アバターに加え、PDF・音声・動画の処理を行う 60 以上のツールを備えています。
主な機能
- 01動画と画像の生成
- 02音声生成とボイスクローン
- 03アバターの作成
- 04PDF・音声・動画の編集と変換
- 05タスク状況の照会
活用シーン
- 01AI アシスタント経由でメディアを生成
- 02声を複製してアバターを作成
- 03PDF・音声・動画を編集または変換
- 04メディア処理タスクの進捗を確認
MCP 対応
ストリーミング可能な HTTP MCP エンドポイントで、メディア生成、編集、変換、タスク照会の 60 以上のツールを提供します。クライアントは bearer API キーで認証します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://medux.io/api/mcp/v1claude mcp add --transport http meduxio-medux https://medux.io/api/mcp/v1{"mcpServers":{"meduxio-medux":{"type":"http","url":"https://medux.io/api/mcp/v1"}}}Cursor で開く{"servers":{"meduxio-medux":{"type":"http","url":"https://medux.io/api/mcp/v1"}}}VS Code で開く{"mcpServers":{"meduxio-medux":{"type":"http","url":"https://medux.io/api/mcp/v1"}}}{"mcpServers":{"meduxio-medux":{"serverUrl":"https://medux.io/api/mcp/v1"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://medux.io/api/mcp/v1認証が必要ツール
詳細
Medux MCP Server
AI アシスタントを Medux に接続して、動画、画像、音声、音声クローン、アバター、PDF/音声/動画ツールなどの AI メディア生成と編集を利用できます。
- エンドポイント(ストリーミング可能な HTTP):
https://medux.io/api/mcp/v1 - 認証:
Authorization: Bearer sk-medux-... - ツール:60 以上(生成、編集、変換、タスクの照会)
1. API キーを取得する
Medux アカウント(https://medux.io)で API キー(sk-medux- で始まるもの)を作成します。
キーは秘密にし、リポジトリにコミットしないでください。
2. GitHub Copilot / VS Code
GitHub Copilot にサインインした VS Code と、Agent モードの Copilot Chat が必要です。
-
コマンドパレットから MCP: Open User Configuration を実行します(⇧⌘P / Ctrl+Shift+P)。
-
サーバーを追加します。
{ "servers": { "medux": { "type": "http", "url": "https://medux.io/api/mcp/v1", "headers": { "Authorization": "Bearer ${input:medux-api-key}" } } }, "inputs": [ { "type": "promptString", "id": "medux-api-key", "description": "Medux API key", "password": true } ] } -
MCP サーバーの一覧で
meduxの横にある歯車を開き、Start Server(または Restart Server)を選択します。 -
Copilot Chat(Agent モード)でツール選択を開き、
meduxのツールが一覧にあることを確認します。 -
まずは「medux を使って、何ができるか一覧表示して」のような、影響のないリクエストを試します。
キーの入力プロンプトが表示されない場合
環境によっては、VS Code に ${input:...} プロンプトが表示されず、ツール呼び出しが Canceled または 401 で終了することがあります。
ヘッダーの値を、ユーザーレベルの mcp.json にキーを直接入力したものに置き換えます(リポジトリには絶対に記載しないでください)。
"headers": { "Authorization": "Bearer sk-medux-xxxxxxxx" }
その後、サーバーを再起動します。
トラブルシューティング
| 症状 | 考えられる原因 |
|---|---|
401 / 認証されていない | Bearer プレフィックスがない、キーが間違っている、または取り消されている |
毎回 Canceled: Canceled になる | キーの入力プロンプトに応答していません。上記のヘッダーにキーを直接記入する方法を使ってください |
NOT_FOUND を伴う 404 | リクエストは Medux に到達しています。タスクまたはリソース ID が存在しません |
| サーバーが一覧にない | MCP: Open User Configuration が正しく保存されたか確認します。歯車 → Show Output からログを確認できます |
レジストリ
.github/workflows/publish-mcp.yml(GitHub OIDC)を通じて、io.github.MeduxIO/medux として MCP Registry に公開されています。
新しいバージョンをリリースするには、server.json の version を更新してから、ワークフローを実行するか、v* タグをプッシュします。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。