vdl-mcp

vdl-mcpは、Model Context Protocolを介してAIアシスタントを自身のvdlサーバーに接続します。真の力はWhisperの相乗効果にあります。

ダウンロード → 文字起こし → アシスタントが内容を理解します。

次のように指示できるようになります。

• 「このYouTube動画をダウンロードして要約してください。」

• 「あの料理のクリップを取得して、レシピをリストとして書き出してください。」

• 「このインタビューでXについて何が言われていましたか？」

• 「この講演の音声をダウンロードして、重要なポイントを教えてください。」

仕組み

これは、vdlのREST APIと通信し、既存のAPIトークンで認証する小さなstdio MCPサーバーです。vdl自体の中では何も実行されません。

ツールグループは安全なデフォルトで切り替え可能です。

無効なグループはアシスタントに表示されません。

Related MCP server: popcorn

必要条件

• 実行中の**vdl**インスタンス。

• MCPトークン: vdlでMCPタブ → トークンを作成し、コピーします。このトークンはスコープ付きです — そこで有効にしたMCPアクションのみを実行できます（書き込み/削除ツールはトグルと読み取り専用モードを尊重し、それ以外はサーバー側で拒否されます）。そのため、汎用のAPIトークンよりも安全です。

インストール

pipxを使用する場合（vdl-mcpがPATHに追加されます）：

pipx install git+https://github.com/sphings79/vdl-mcp

またはuvを使用する場合：

uv tool install git+https://github.com/sphings79/vdl-mcp

Claude Desktopに接続する

Claude Desktopの設定（claude_desktop_config.json）に以下を追加します：

{
  "mcpServers": {
    "vdl": {
      "command": "vdl-mcp",
      "env": {
        "VDL_URL": "http://localhost:8000",
        "VDL_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Desktopを再起動すると、vdlツールが表示されます。（MCP対応のクライアントはすべて同様に動作します。vdl-mcpコマンドをstdio経由で実行するだけです。）

Dockerで実行する

コンテナがお好みですか？GHCRに公開済みのビルド済みイメージがあります — コマンドとして使用します：

{
  "mcpServers": {
    "vdl": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
               "-e", "VDL_URL", "-e", "VDL_TOKEN",
               "ghcr.io/sphings79/vdl-mcp:latest"],
      "env": {
        "VDL_URL": "http://host.docker.internal:8000",
        "VDL_TOKEN": "your-api-token"
      }
    }
  }
}

-i（stdio用に標準入力を開いたままにする）オプションと、vdlが同じホストで実行されている場合、host.docker.internal（コンテナが到達できるようにする）に注意してください。

Web UIはありません — 設計上の意図

vdl-mcpは、MCPクライアントによってローカルで起動されるstdioプロセスです。ネットワークポートを開かないため、ログインページもfail2banもありません — 受信を保護するものは何もありません。そのセキュリティモデルは次の通りです：APIトークンを非公開に保ち、破壊的なツールをオフにして（デフォルト）、必要に応じてドメイン許可リストを設定します。認証とブルートフォース攻撃の保護はvdl自体にあります。（リモートのマルチクライアントHTTPサーバーが必要な場合は、別のトランスポートです — issueを開いてください。）

ツール

• resolve(url) — リンクを分析し、アイテムと利用可能な品質を一覧表示します（ダウンロードはしません）。

• download(url, audio=False, section="", wait=True) — 最高品質（またはMP3）でダウンロードします。sectionは0:30-1:00のようにクリップを指定します。waitは完了したファイルのnameを返します。

• transcribe(name, language="") — Whisperによる文字起こし → テキストを返します（vdlでWhisperモデルが設定されている必要があります）。

• get_transcript(name) — 既存の文字起こしのテキストを返します。

• list_files(query, service, label, limit) — ダウンロードを閲覧します。

• job_status(job_id) — ダウンロードジョブの状態を確認します。

• (デフォルトでオフ) delete_file, bulk, get_settings。

設定（環境変数）

すべてのツールは、説明内に**［読み取り］、［書き込み］、［削除］**のタグが付いており、あなたとアシスタントの両方が一目でリスクを認識できます。

vdlのWeb UIからも管理できます： vdlで設定 → MCPタブに移動し、各ツールを切り替えます（読み取り専用マスタースイッチとリスクチップ付き）。vdl-mcpは起動時にその設定を取得するため、環境変数は不要です。変更後はvdl-mcpを再起動してください。ツールが公開されるかどうかの優先順位：読み取り専用（環境変数またはUI）→ ツールごとの環境変数オーバーライド → Web UI → グループフラグ。

セキュリティに関する注意

• アシスタントはあなたのトークンを通じてあなたとして動作します — 非公開に保ってください。

• 破壊的なツールはデフォルトでオフです。 意識的に有効にしてください。

• アシスタントのリクエストに応じて任意のURLをダウンロードすることは、プロンプトインジェクションの表面になります。VDL_MCP_DOMAIN_ALLOWLIST（例：youtube.com,instagram.com）を設定して制限してください。

• 自分が所有している、またはダウンロードする権利/許可があるコンテンツにのみ使用してください — vdlと同じ免責事項が適用されます。

ライセンス

GNU Affero General Public License v3.0（AGPL-3.0） — LICENSEを参照してください。© 2026 sphings79