videohub-port

videohub-port

YouTube の動画、チャンネル、再生リストを MCP ツールとして提供し、YouTube Data API v3 と通信します。videohub-port は、コミュニティ製 YouTube MCP サーバーの中核的な機能を、新しい名前のもとでクリーンルーム方式で再構築したものです。コードは新規に作成されており、ブランド表記のコピーはありません。

認証方式：TOKEN/KEY-ENV のみ。公開データの読み取りには YouTube Data API v3 を使用し、YOUTUBE_API_KEY を key クエリパラメーターとして送信します。コミュニティ製の元実装にある OAuth フロー（アップロード、登録チャンネルの変更、自分のチャンネルの管理用）は再現していません。このサブセットには書き込みツールはありません。

ツール（コアサブセット、12 個）

search_videos、get_video、list_video_comments、 get_channel、search_channels、list_playlists、 get_playlist、list_playlist_items、get_video_transcript、 list_channel_videos、get_video_categories、 get_trending_videos。

文字起こしツールは簡略化されています。Data API の呼び出しではありません。指定された言語トラックについて、公開 timedtext エンドポイントを fmt=json3 で直接取得し（字幕トラックの一覧表示や選択は行わず、キーのパラメーターも不要）、json3 のイベントをプレーンテキストに結合します。利用可能なトラックがない場合は、実際の状況を示す「字幕トラックが利用できません」というエラーを返し、テキストを捏造することはありません。

このサブセットに含まれないもの：OAuth フローとすべての書き込み機能（アップロード、再生リストの作成・編集、登録チャンネル、評価、コメントの投稿）、OAuth が必要な自分のチャンネルや登録チャンネルの読み取り、ライブストリーミング、動画の挿入・更新・削除、チャンネルのセクションやブランディング、カテゴリやトレンドの地域設定を超える i18n の詳細、アナリティクス API、srt/vtt 形式での字幕のダウンロードや字幕トラックの一覧表示。

セットアップ

Google Cloud コンソールで API キーを作成し（YouTube Data API v3 を有効にします）、設定してください：

export YOUTUBE_API_KEY=AIza...

必要に応じて、API のベース URL は YOUTUBE_API_BASE_URL （デフォルトは https://www.googleapis.com/youtube/v3）、文字起こしのベース URL は YOUTUBE_TIMEDTEXT_BASE_URL（デフォルトは https://www.youtube.com/api/timedtext）で上書きできます。すべての Data API リクエストには Accept: application/json と、key クエリパラメーターとしてキーが含まれます（Authorization ヘッダーは使用しません）。キーがない場合、すべてのツール呼び出しは、不足している変数名を示すエラーで失敗します。

CLI

npx @reneturcios/videohub-port search_videos '{"query":"lo fi"}'
npx @reneturcios/videohub-port mcp        # stdio MCP server

各ツール名は、1 つの JSON オブジェクトを引数として受け取るサブコマンドです。

MCP クライアントの設定

{
  "mcpServers": {
    "videohub-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/videohub-port", "mcp"],
      "env": { "YOUTUBE_API_KEY": "AIza..." }
    }
  }
}

Docker

docker run -i -e YOUTUBE_API_KEY ghcr.io/cloudcorprecords/videohub-port

開発

npm install
npm run build
npm test

ライセンス

MIT