Youtube MCP Server

🚀 YouTube モデルコンテキストプロトコル (MCP) サーバ

このサーバは、YouTube API を利用したモデルコンテキストプロトコルの実装です。様々な YouTube 関連の操作を行うことができます。

🚀 クイックスタート

このサーバを使用するには、まずインストールと設定が必要です。以下の手順に従って進めてください。

📦 インストール

Smithery を通じたインストール

npx -y @smithery/cli install @ZubeidHendricks/youtube --client claude

手動インストール

1. リポジトリのクローン

   git clone https://github.com/ZubeidHendricks/youtube-mcp-server.git
   cd youtube-mcp-server
   

2. 依存関係のインストール

   npm install
   

📚 ドキュメント

環境変数の設定

• YOUTUBE_API_KEY：YouTube API へのアクセスに使用するキーです。
• YOUTUBE_TRANSCRIPT_LANG（オプション）：デフォルトの字幕言語です。"en" を指定すると英語が使用されます。

VS Code プラグインのインストール

VS Code のユーザー設定 (JSON) ファイルに以下の内容を追加してください。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "YouTube API Key",
        "password": true
      }
    ],
    "servers": {
      "youtube": {
        "command": "npx",
        "args": ["-y", "zubeid-hendricks/youtube-mcp-server"],
        "env": {
          "YOUTUBE_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

YouTube API の設定

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. YouTube Data API v3 を有効にします。
4. API 認証情報を作成し、キーを取得します。
5. キーを設定ファイルにコピーします。

💻 使用例

基本的な使用法

動画管理

// 動画詳細の取得
const video = await youtube.videos.getVideo({
  videoId: "video-id"
});

// 動画字幕の取得
const transcript = await youtube.transcripts.getTranscript({
  videoId: "video-id",
  language: "en"
});

// 動画の検索
const searchResults = await youtube.videos.searchVideos({
  query: "検索語",
  maxResults: 10
});

チャンネル管理

// チャンネル詳細の取得
const channel = await youtube.channels.getChannel({
  channelId: "channel-id"
});

// チャンネルの動画一覧
const videos = await youtube.channels.listVideos({
  channelId: "channel-id",
  maxResults: 50
});

プレイリスト管理

// プレイリストアイテムの取得
const playlistItems = await youtube.playlists.getPlaylistItems({
  playlistId: "playlist-id",
  maxResults: 50
});

// プレイリスト詳細の取得
const playlist = await youtube.playlists.getPlaylist({
  playlistId: "playlist-id"
});

🔧 開発手順

# 依存関係のインストール
npm install

# テストの実行
npm test

# プロジェクトのビルド
npm run build

# コードのチェック
npm run lint

🤝 貢献ガイド

このプロジェクトに貢献する方法については、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。