YouTube MCP サーバー

これは、Claude やその他の AI アシスタントが YouTube API と連携できるようにする MCP（Model Context Protocol）サーバーです。このサーバーは、動画の検索、特定の動画の詳細情報の取得、チャンネルの検索、チャンネルの詳細情報の取得などのツールを提供します。

MCPとは何ですか?

モデルコンテキストプロトコル（MCP）は、Anthropic（Claudeの開発元）がAIアシスタントを外部データソースやツールに接続するために開発したオープンスタンダードです。これにより、Claudeのようなモデルは最新の情報にアクセスし、外部システムで標準化された方法でアクションを実行できるようになります。

MCP は AI の「ユニバーサル ブリッジ」として機能し、モデルがさまざまなコンテンツ リポジトリ、ビジネス サービス、またはアプリケーションにアクセスするための標準化された方法を提供します。

Related MCP server: YouTube Toolbox

要件

• Node.js v16以上

• YouTube API キー（Google Developer Console から取得）

インストール

1. このリポジトリをクローンします:

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

2. 依存関係をインストールします:

npm install

3. プロジェクト ルートに.envファイルを作成し、YouTube API キーを追加します。

YOUTUBE_API_KEY=your_api_key_here

実行

サーバーを起動するには、次のコマンドを実行します。

npm start

Claude Desktopとの統合

この MCP サーバーを Claude Desktop で使用するには、 claude_desktop_config.jsonファイル (通常、Windows の場合は%APPDATA%\Claude\ 、macOS の場合は~/Library/Application Support/Claude/にあります) に次の構成を追加します。

{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["path/to/youtube-mcp-server/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "your_api_key_here"
      }
    }
  }
}

"path/to/youtube-mcp-server/index.js" index.jsファイルへの絶対パスに置き換え、 "your_api_key_here" YouTube API キーに置き換えます。

利用可能なツール

1. 動画を検索する

クエリに基づいて YouTube 上の動画を検索します。

search_videos

パラメータ:

• query （文字列、必須）: 検索用語

• maxResults (数値、オプション): 結果の最大数 (1～50)

• pageToken (文字列、オプション): 次の結果ページを取得するためのトークン

2. ビデオの詳細を取得する

特定のビデオに関する詳細情報を取得します。

get_video_details

パラメータ:

• videoId (文字列、必須): YouTube 動画 ID

3. チャンネルの詳細を取得する

特定のチャネルに関する詳細情報を取得します。

get_channel_details

パラメータ:

• channelId (文字列、必須): YouTube チャンネル ID

4. チャンネルを検索する

クエリに基づいて YouTube のチャンネルを検索します。

search_channels

パラメータ:

• query （文字列、必須）: 検索用語

• maxResults (数値、オプション): 結果の最大数 (1～50)

• pageToken (文字列、オプション): 次の結果ページを取得するためのトークン

利用可能なリソース

• youtube://popular/videos : YouTubeで現在人気の動画のリスト

使用例

Claude Desktop を使用すると、次のような質問をすることができます。

• 「Pythonプログラミングビデオを検索」

• 「ID dQw4w9WgXcQのビデオの詳細を表示」

• 「料理関連のチャンネルを検索」

• 「GoogleDevelopersチャンネルに関する情報を教えてください」

• 「今一番人気の動画は何ですか？」

YouTube APIキーの取得

YouTube API キーを取得するには:

1. Google Developer Consoleにアクセスしてください

2. 新しいプロジェクトを作成する（または既存のプロジェクトを選択する）

3. サイドバーで「APIライブラリ」を選択します

4. 「YouTube Data API v3」を検索して有効にします

5. サイドバーで「認証情報」を選択します

6. 「認証情報を作成」をクリックし、「APIキー」を選択します

7. 生成されたキーをコピーして、 .envファイルまたは Claude Desktop 構成で使用します。

トラブルシューティング

エラーが発生した場合は、以下を確認してください。

1. npm installですべての依存関係をインストールしたこと

2. YouTube APIキーが有効であること

3. Google プロジェクトで YouTube Data API v3 が有効になっていること

4. Node.jsバージョン16以上を使用していること

5. Claude Desktop を使用している場合は、 %APPDATA%\Claude\logs\ (Windows) または~/Library/Logs/Claude/ (macOS) のログを確認してください。

貢献

貢献を歓迎します。いくつかの方法で協力することができます。

1. バグや問題の報告

2. 新機能の提案

3. 改善や修正を含んだプルリクエストを送信する

4. ドキュメントの改善

接続とサポート

• X (Twitter) でフォローしてください: @Nocodeboy

• このプロジェクトが役に立つと思われ、サポートを表明したい場合は、次の手順に従ってください。

ライセンス

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