Playlist MCP Server

PythonベースのMCPサーバープロジェクトで、ClaudeなどのAIアシスタントと連携し、ユーザーの気分やテーマに基づいて.m3u形式のローカル音楽プレイリストを生成し、指定されたディレクトリに保存します。

エンターテインメントとメディア人工知能チャットボット #音楽再生 #AI連携 #ローカルファイル .Python

スコア : 2.5ポイント

ダウンロード数 : 9.4K

更新時間 : 2025-04-29

サイトを開く

MCPプレイリストジェネレーターとは？

MCPプレイリストジェネレーターは、あなたの現在の気分や好きな音楽テーマに基づいて、コンピュータ内の音楽ファイルを自動的にスキャンし、一致するプレイリストを生成するスマートなツールです。生成されたプレイリストは、あなたの好きな音楽プレーヤーで直接使用できます。

MCPプレイリストジェネレーターの使い方は？

AIアシスタント（Claudeなど）に、あなたが望むプレイリストのタイプ（例：「リラックスした夜の音楽」や「楽しい仕事のバックグラウンドミュージック」）を伝えるだけで、システムが自動的にプレイリストファイルを作成して保存します。

適用シーン

パーティー、仕事の集中、運動、リラックスなど、特定の雰囲気の音楽リストをすぐに作成したいときに特に便利です。大量のローカル音楽を持っているが、整理方法がわからないユーザーにも適しています。

主な機能

自動プレイリスト生成

あなたが説明した気分やテーマに基づいて自動的にプレイリストを作成します。

スマート音楽分析

音楽ファイルのメタデータ（ジャンル、アーティストなど）を読み取り、最適な曲をマッチングします。

多形式対応

MP3など、複数のオーディオ形式の音楽ファイルをサポートします。

保存場所のカスタマイズ

ユーザーがプレイリストファイルの保存場所を指定できます。

利点

曲を手動で選ぶ必要がなく、時間を節約します。

AIを利用してあなたの音楽嗜好を理解します。

生成されたプレイリストは、一般的なプレーヤーで直接使用できます。

完全にオフラインで処理され、プライバシーが保護されます。

制限

事前にコンピュータに音楽ファイルを保存しておく必要があります。

音楽ファイルのメタデータの正確性に依存します。

一部の特殊な音楽形式はサポートされない場合があります。

初回使用時に簡単な設定が必要です。

使い方

必要なソフトウェアをインストールする

コンピュータにPythonと必要なライブラリ（uvとmutagen）をインストールします。

MCPサーバーを起動する

プロジェクトをクローンした後、サーバーを起動します。

音楽プレーヤーを更新する

プレイリストを作成した後、音楽アプリで再インデックスを作成して新しいリストを表示することを忘れないでください。

使用例

リラックス音楽リストの作成

仕事の後にリラックスするために、リラックスした音楽を聴きたい場合。

パーティー音楽の準備

家庭パーティーのために、盛り上がる音楽を準備する場合。

よくある質問

保存場所を指定しない場合、プレイリストはどこに保存されますか？

どの音楽ファイル形式がサポートされていますか？

新しく作成したプレイリストが音楽アプリにすぐに表示されないのはなぜですか？

🚀 情境モデル提供者（MCP）プレイリスト生成器

このプロジェクトは、Claudeやその他のサポートツールで使用されるAIアシスタント向けの情境モデル提供者（MCP）サーバーです。ユーザーの現在の気分やテーマに基づいて、ユーザーのローカルコンピューター上に.m3uプレイリストを生成します。生成されたプレイリストはユーザーが指定したディレクトリに保存され、好きなメディアプレイヤーですぐに再生できます。

Pythonで構築され、uvとmutagenによって駆動されています。伝説的なファイルシステムMCPサーバーに着想を得ています。このアイデアと基礎的な参考に感謝いたします！

🚀 クイックスタート

このサーバーを使えば、Claudeや他のLLMエージェントからのリクエストに応じて、ユーザーの気分やテーマに合った.m3uプレイリストを生成できます。

✨ 主な機能

Claudeや他のAIアシスタントからのリクエストを受け付ける。
ユーザーのローカル音楽ファイルをスキャンし、指定された気分やテーマに合った曲を抽出する。
.m3u形式のプレイリストを生成し、指定されたディレクトリに保存する。

📦 インストール

必要なパッケージをインストールします。

pip install uv mutagen

このリポジトリをクローンしてサーバーを起動します。

uvicorn mcp_server:app --reload

💻 使用例

基本的な使用法

Claudeに以下のようなプロンプトを与えます。

“嘿Claude，你能为我创建一个快乐心情的播放列表吗？”

ClaudeはMCPサーバーツールを使用して、指定された気分に合ったプレイリストを生成します。生成されたプレイリストは指定されたディレクトリに保存され、音楽アプリケーションで再生できます。

⚠️ 重要提示

プレイリストを作成した後は、Musicアプリケーションを再インデックスすることを確認してください。

🔧 技術詳細

技術スタック

Python
uv — 非同期Webサーバー
mutagen — メタデータ抽出用

仕組み

ユーザーがMCPサーバーをセットアップ：Pythonとuvを使用してサーバーを設定します。
サーバーがリクエストを待機：Claudeや他のLLMエージェントからのリクエストを待機します。
リクエストに応じてプレイリストを生成：例えば「快適な夜のプレイリストを作成して」というリクエストがあった場合、以下の処理を行います。
- ローカルの音楽ファイルをスキャンします。
- mutagenを使用してメタデータ（ジャンル、タイトル、アーティストなど）を読み取ります。
- 指定された気分に合った曲をフィルタリングします。
- .m3uプレイリストを作成します。
- ユーザーのマシン上の指定された場所に保存します。