🚀 YouTube 音楽 MCP サーバー

このプロジェクトは、AI モデルが Google Chrome を通じて YouTube 音楽の再生を制御できるようにする、モデルコンテキストプロトコル（MCP）サーバーを実装しています。AI アシスタントと音楽再生の間の架け橋となり、AI が曲名とアーティスト名に基づいて曲を検索し再生することを可能にします。

🚀 クイックスタート

このサーバーを使用することで、AI モデルが YouTube 音楽を自在に操作できるようになります。以下のセクションで詳細な機能や開発・インストール方法を説明します。

✨ 主な機能

• YouTube 音楽内の曲を検索する
• Google Chrome 内で直接曲を再生する
• 曲名とアーティスト名による検索をサポートする
• エラー処理とログ記録を行う
• クロスプラットフォーム対応（主に macOS の Chrome 自動化を対象）

📦 インストール

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？

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

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

MCP の詳細を知るには：

• MCP ドキュメント
• MCP SDK

架构

高阶概述

youtube-music-server MCP サーバー

モデルコンテキストプロトコルに基づくサーバー

これは TypeScript ベースの MCP サーバーで、以下の機能を提供することで、核心的な MCP 概念を示しています。

• note:// URI を通じてテキストノートを一覧表示し、アクセスする
• 各ノートにはタイトル、内容、メタデータがある
• 新しいノートを作成するツール
• すべての保存されたノートの要約を生成するプロンプト

機能

リソース

• note:// URI を通じてノートを一覧表示し、アクセスする
• 各ノートはタイトル、内容、メタデータを持つ
• シンプルな内容アクセスのためのシンプルなテキスト MIME タイプ

ツール

• create_note - 新しいテキストノートを作成する
  • タイトルと内容を必須パラメータとして使用する
  • サーバー状態にノートを保存する

プロンプト

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

💻 使用例

基本的な使用法

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

npm install

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

npm run build

自動再構築機能付きで開発するには：

npm run watch

高度な使用法

Claude Desktop と一緒に使用する場合、上述のサーバー設定を追加してください。また、デバッグには MCP インスペクター を使用することをおすすめします。

npm run inspector

インスペクターはブラウザでデバッグツールにアクセスするための URL を提供します。