Youtube Music MCP Server

🚀 YouTube音乐MCPサーバ

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

🚀 クイックスタート

このサーバを使用することで、AIモデルは曲名やアーティスト名を指定してYouTube Musicで曲を検索し、Google Chrome上で直接再生することができます。

✨ 主な機能

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

📚 ドキュメント

什么是MCP？

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

• 利用可能なツールを発見する
• ツールの機能を理解する
• これらのツールを介した操作を実行する
• 応答とエラーを処理する

MCPに関する詳細は以下を参照してください。

• MCPドキュメント
• MCP SDK

アーキテクチャ

高レベル概要

これはTypeScriptベースのMCPサーバで、シンプルなノートシステムを実装しています。以下の機能により、MCPの核心概念をデモンストレートしています。

• note:// URIリストを介して、メタデータ付きのテキストノートを一覧表示し、アクセスする
• 各ノートにはタイトル、内容、メタデータがある
• 基本的な内容アクセスには単純なテキストmimeタイプを使用する

ツール

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

プロンプト

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

📦 インストール

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"
    }
  }
}

💻 使用例

基本的な使用法

開発

依存関係をインストールする：

npm install

サーバをビルドする：

npm run build

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

npm run watch

高度な使用法

デバッグ

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

npm run inspector

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