🎧 MCP Playlist Generator

🎧 MCP プレイリストジェネレーター

このプロジェクトは、Claude またはツールの使用に対応したあらゆる AI アシスタントと連携するために設計された Model Context Provider（MCP）サーバーです。ユーザーの現在の気分やテーマに基づいて、ユーザーの PC 上に .m3u プレイリストを生成します。プレイリストはユーザーが指定したディレクトリに保存され、お気に入りのメディアプレーヤーですぐに再生できます。

Python で構築され、uv と mutagen を使用しています。伝説的な Filesystem MCP Server に着想を得ています。アイデアと基礎となる参考資料を提供してくれたことに、心から感謝します！

---

🛠 動作の仕組み

1. Python と uv を使って、ユーザーが MCP サーバーをセットアップします。
2. サーバーは、Claude または任意の LLM エージェントからのリクエストを待ち受けます。
3. リクエスト（例：「落ち着いた夜のプレイリストを作って」）に基づいて、次の処理を行います。
   • ローカルの音楽ファイルをスキャンします。
   • mutagen を使ってメタデータ（ジャンル、タイトル、アーティストなど）を読み取ります。
   • 雰囲気に合った曲を絞り込みます。
   • .m3u プレイリストを作成します。
   • ユーザーのマシン上の指定された場所に保存します。

---

🔧 技術スタック

• Python
• uv — 非同期ウェブサーバー用
• mutagen — メタデータの抽出用

---

📦 インストール

pip install uv mutagen

このリポジトリをクローンして、次を実行します。

uvicorn mcp_server:app --reload

🧠 Claude へのプロンプト例

「ねえ Claude、明るい雰囲気のプレイリストを作ってくれる？」

すると Claude が MCP サーバーのツールを使い、あっという間に音楽アプリでプレイリストを再生できるようになります。

重要

プレイリストの作成後、Music アプリの re-index を忘れずに実行してください。

🙏 謝辞

Filesystem MCP Server に心から感謝します。このプロジェクトは、そのアイデアに着想を得て生まれました。

💬 フィードバックをお待ちしています

イシューを作成するか、気軽にご連絡ください。PR も歓迎です。気分に合わせたプレイリストの提案は、さらに大歓迎です 🎶

---

確認したいこと：

• ユーザーが保存先を選択しなかった場合、デフォルトの保存先はどこですか？
• MP3 のみ対応していますか？それとも、ほかの形式にも対応していますか？
• 開発者向けに API ルートの構成を含めたほうがよいですか？

ご意見をお聞かせください。内容を更新します。