epheterson/applemusic-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

125 stars 23 forks Качество 85 Тренд 30MIT

epheterson/applemusic-mcp — это кандидат на сервер MCP, импортированный из https://github.com/epheterson/applemusic-mcp.

Обзор

epheterson/applemusic-mcp — это кандидат на сервер MCP, импортированный из https://github.com/epheterson/applemusic-mcp.

Обзор (машинный перевод)

MCP-сервер для Apple Music. Он даёт любому клиенту MCP (Claude, Cursor, Cline, Windsurf) контроль над вашими плейлистами, библиотекой, каталогом, поиском, воспроизведением и очередью Up Next. Работает на macOS, Windows и Linux.

Вам достаточно подписки Mac или Apple Music. Четыре движка, выбираемых для каждого вызова: Music.app и Safari на Mac, API Apple Music и Chrome на любой ОС.

Особенности

Четыре движка поддерживают сервер. Native управляет локальным Music.app на macOS через AppleScript. API использует веб-API Apple Music (amp-api.music.apple.com) на любой ОС. Safari управляет вашим авторизованным MusicKit Safari на macOS (DRM-нативный, нулевой установка). Chrome запускает локальное окно Google Chrome с MusicKit для DRM-аудио на любой ОС. Одно предпочтение mode выбирает движок — auto (по умолчанию) смешивает лучшее: нативные Music.app для воспроизведения на macOS, Safari для очереди Up Next, API для данных, Chrome вне Mac. Зафиксируйте один с помощью native / safari / chrome / api, или переопределите один вызов воспроизведения/очереди с помощью engine=. В таблице ниже столбец Browser охватывает как веб-плееры Safari, так и Chrome. ✓ поддерживается, ✗ невозможна на этом движке, — там не применимо.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

applemusic-mcp

MCP server for Apple Music. It gives any MCP client (Claude, Cursor, Cline, Windsurf) control of your playlists, library, catalog, discovery, playback, and the Up Next queue. Runs on macOS, Windows, and Linux.

A Mac or an Apple Music subscription is all you need.

“Create a playlist called Road Trip and fill it with upbeat 90s alternative.” · “Play my workout playlist on shuffle, and queue up Bohemian Rhapsody next.” · “What have I been listening to lately, and what’s topping the charts?”

Choose how much it can reach

You decide what this server may touch, in your MCP client’s config. The assistant can’t change it, and tools that need more than you allowed aren’t offered to it at all.

`--level`	It can reach	Good for
`music`	Only the Music app on your Mac. No network, no browser.	Your library, playlists, playback, ratings, AirPlay
`api`	+ Apple’s music service over the internet	Searching and adding from the full catalog, recommendations, Windows and Linux
`web`	+ a Safari or Chrome web player	The Up Next queue, and playback off the Mac
`full`	Everything, including clicking inside the Music app	Every feature, nothing to decide
`--allow-ui` (with any level)	+ clicking inside the Music app (macOS Accessibility)	Playing catalog songs with no sign-in

Start with music and move up when you want a feature that needs more. Leaving --level off is the same as full for now, as before 0.21.

For a Mac app with a guided setup instead of a terminal command, consider the community fork secure-applemusic-mcp-for-osx.

Features

What each engine can do, and the level that turns it on. ✓ supported, ✗ not possible there, — not applicable.

Capability	Music.app (macOS) · `music`	Apple Music API (any OS) · `api`	Web player (Safari / Chrome) · `web`
Catalog search / browse	✓	✓ (+ tokenless resolve)	—
Recommendations / charts / suggestions	✗	✓	—
Library search / browse	✓	✓	—
Genre search	✓	✗	—
Recently played / added	✓	✓	—
Add catalog → library	✓	✓	✓ (in-page POST)
Remove from library	✓	✓	—
Love / dislike	✓	✓	—
1–5 star ratings	✓	✗	✗
Favorites list	✓	✗	✗
Playlist create / add / remove / rename	✓	✓	—

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "Apple Music": {
      "command": "applemusic-mcp",
      "args": ["serve", "--level", "music"]
    }
  }
}