YouTube MCP Server

YouTube MCP サーバー

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

MCP とは？

Model Context Protocol（MCP）は、AI アシスタントを外部のデータソースやツールに接続するために、Anthropic（Claude の開発元）が策定したオープン標準です。Claude のようなモデルが、最新情報にアクセスしたり、外部システムで操作を実行したりするための標準化された方法を提供します。

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

要件

• 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（string、必須）：検索語句
• maxResults（number、任意）：結果の最大件数（1〜50）
• pageToken（string、任意）：次の結果ページを取得するためのトークン

2. 動画の詳細情報を取得

特定の動画の詳細情報を取得します。

get_video_details

パラメーター：

• videoId（string、必須）：YouTube 動画 ID

3. チャンネルの詳細情報を取得

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

get_channel_details

パラメーター：

• channelId（string、必須）：YouTube チャンネル ID

4. チャンネルを検索

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

search_channels

パラメーター：

• query（string、必須）：検索語句
• maxResults（number、任意）：結果の最大件数（1〜50）
• pageToken（string、任意）：次の結果ページを取得するためのトークン

利用可能なリソース

• youtube://popular/videos：現在 YouTube で人気の動画の一覧

使用例

Claude Desktop では、次のような質問ができます：

• 「Python プログラミングの動画を検索して」
• 「ID が dQw4w9WgXcQ の動画の詳細を見せて」
• 「料理関連のチャンネルを検索して」
• 「GoogleDevelopers チャンネルの情報を教えて」
• 「現在最も人気のある動画は何？」

YouTube API キーの取得

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

1. Google Developer Console にアクセスします
2. 新しいプロジェクトを作成します（または既存のプロジェクトを選択します）
3. サイドバーで「API Library」を選択します
4. 「YouTube Data API v3」を検索し、有効にします
5. サイドバーで「Credentials」を選択します
6. 「Create credentials」をクリックし、「API key」を選択します
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 の下でライセンスされています。詳しくは LICENSE ファイルをご覧ください。