YouTube Music MCP Server

YouTube Music MCP サーバー

概要

このプロジェクトは、Google Chrome を通じて AI モデルが YouTube Music の再生を操作できるようにする Model Context Protocol（MCP）サーバーを実装しています。AI アシスタントと音楽再生の橋渡しをし、曲名やアーティスト名に基づいて AI が曲を検索して再生できるようにします。

MCP とは？

Model Context Protocol（MCP）は、AI モデルが外部のツールやサービスとやり取りするための標準化された方法です。AI アシスタントが以下を行えるようにする、構造化された通信プロトコルを提供します。

• 利用可能なツールを検出する
• ツールの機能を理解する
• これらのツールを通じてアクションを実行する
• 応答とエラーを一貫して処理する

MCP の詳細はこちらをご覧ください。

• MCP ドキュメント
• MCP SDK

機能

• YouTube Music で曲を検索
• Google Chrome で曲を直接再生
• 曲名とアーティスト名による検索に対応
• エラー処理とログ記録
• クロスプラットフォームに対応（Chrome の自動化については macOS を中心に設計）

アーキテクチャ

概要

youtube-music-server MCP サーバー

Model Context Protocol サーバー

これは、シンプルなメモシステムを実装した TypeScript ベースの MCP サーバーです。以下を提供し、MCP の主要な概念を説明します。

• URI とメタデータを持つテキストメモを表すリソース
• 新しいメモを作成するツール
• メモの要約を生成するプロンプト

機能

リソース

• note:// URI を使ってメモを一覧表示し、アクセスできます
• 各メモにはタイトル、内容、メタデータがあります
• コンテンツに簡単にアクセスできるプレーンテキストの MIME タイプ

ツール

• create_note - 新しいテキストメモを作成します
  • 必須パラメーターとしてタイトルと内容を受け取ります
  • サーバーの状態にメモを保存します

プロンプト

• summarize_notes - 保存されたすべてのメモの要約を生成します
  • すべてのメモの内容を埋め込みリソースとして含めます
  • LLM による要約用の構造化されたプロンプトを返します

開発

依存関係をインストールします。

npm install

サーバーをビルドします。

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

インストール

Claude Desktop で使用するには、サーバーの設定を追加します。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "youtube-music-server": {
      "command": "/path/to/youtube-music-server/build/index.js"
    }
  }
}

デバッグ

MCP サーバーは stdio を介して通信するため、デバッグが難しい場合があります。MCP Inspector の使用をおすすめします。これはパッケージスクリプトとして利用できます。

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。