music-digger-mcp

YouTube + Safari + Apple Music で音楽を掘るための MCP サーバー。Claude Code から自然言語で操作し、聴いて反応した曲だけを Obsidian Vault に蓄積する。

v0.2.0 で再生エンジンを YouTube に切り替えました。 旧 Apple Music + AppleScript ベースの理由は docs/superpowers/specs/2026-06-13-youtube-pivot.md を参照。

ワークフロー

1. play_station("Roy Ayers") → YouTube 検索 → Safari で再生（autoplay 無し、MCP が制御）

2. 気に入ったら mark_current("love") → Obsidian 日記に追記 + iTunes Search API で楽曲を照合 → Music.app で同じ楽曲ページを開く（あとはユーザーが「+」でライブラリ追加・再生）

3. love 1 回 or like 2 回でアルバムカードに自動昇格

Apple Music カタログの「特定の曲」を AppleScript から再生する公式 API は無く、URL を open しても navigate するだけで自動再生しない。digger としての再生は YouTube + Safari に統一し、Apple Music は「気に入った曲をあとで聴くための着地点」として使い分ける。

Related MCP server: mcp-apple-music

Tools

• play_station(seed?) — YouTube 検索で seed の station を Safari で起動。seed 省略時は music/stations.md からランダム

• play_album(artist, album) — <artist> <album> full album で YouTube 検索 → Safari

• current_track() — MCP が「最後に再生指示した曲」の情報を返す（ブラウザに問い合わせない）

• mark_current(reaction, note?, artist?, album?, track?) — 現在曲を love / like / meh / skip でマーク。日記追記 + 昇格判定。love / like の時は iTunes Search API で Apple Music カタログを引いて、Music.app に楽曲ページを開く

動作環境

• macOS（Safari、Music.app、open コマンド）

• Node.js 18+ (built-in fetch)

• YouTube アカウント（Safari でログイン推奨。Premium ならバックグラウンド再生・広告無し）

• Apple Music サブスクリプション（love した曲を Music.app で続けるなら）

• Obsidian Vault

セットアップ

npm install
npm run build

Safari で YouTube にログインしておく（Premium 推奨）。youtube.com の autoplay は OFF にしておくと state ずれが起きない。

Claude Code への接続

examples/mcp.json を参考に、Claude Code の .mcp.json に music-digger エントリを追加して再起動する。

開発

npm run dev          # tsx watch でホットリロード
npm test             # vitest
npm run test:watch   # vitest watch

環境変数

stations.md の書き方

## ソウル / ファンク
- Aaron Frazer       # Introducing... が今のお気に入り (Bad News)
- Curtis Harding     # ◎ The Power
- Roy Ayers          # ◎ Everybody Loves The Sunshine

## スキップ中
# - Lofi             # 今の気分じゃない

• 行頭 - で 1 行 1 seed

• 行頭が # の行はコメント / 無効化

• 末尾の # ... は seed の覚え書き（パーサーが無視する）

仕様書 / 実装計画

• docs/superpowers/specs/2026-06-12-music-digger-mcp-design.md — 初版（Apple Music ベース、現在は参考資料）

• docs/superpowers/specs/2026-06-13-youtube-pivot.md — YouTube 移行設計メモ

• docs/superpowers/plans/2026-06-12-music-digger-mcp.md — 旧実装計画

注意

• YouTube の HTML スクレイピングを使用しているため、YouTube 側のレイアウト変更で壊れる可能性があります（個人用前提）

• current_track は MCP がこのセッションで再生指示した曲のみを反映します。ブラウザ上で手動で次の曲に進めた場合は state がずれます（その間 mark_current を呼ばなければ実害なし）

• mark_current の love / like で Music.app の楽曲ページが開きますが、ライブラリへの追加は手動で「+」を押してください