iTunes/Apple Music CLI & MCP Server
High-performance command-line tool and MCP server for iTunes/Apple Music integration on macOS
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดA Go-based tool that bridges command-line interfaces and AI applications with your Apple Music library. Features ultra-fast search (<7ms via SQLite FTS5), smart playback control, and integration with Large Language Models through the Model Context Protocol (MCP).
context.Context flows from MCP requests down to SQLite queries and JXA processes, so cancellation propagates end to endvim-plugin/)This project evolved from a legacy VIM plugin for iTunes integration. The original plugin remains untouched in the master branch as a reference. The current implementation is a complete rewrite focused on modern Apple Music integration, database performance, and AI/LLM compatibility through the MCP protocol — and includes a rewritten Vim plugin (vim-plugin/) that fronts the Go CLI instead of JXA scripts.
+-------------------+ +--------------------+ +-------------------+
| CLI Tool | | MCP Server | | Apple Music |
| (itunes) | | (mcp-itunes) | | Desktop App |
+---------+---------+ +---------+----------+ +---------+---------+
| | |
+----------+-------------+ |
| |
+----------v------------+ +----------v--------+
| itunes.Client | | JXA Scripts |
| (core library) |<-------------+ (via osascript |
+----------+------------+ | stdin) |
| +-------------------+
+----------v------------+
| SQLite Database |
| FTS5 Search |
+-----------------------+
osascript via stdin (no temp files) to drive the Apple Music app.git clone <repository-url>
cd itunes
go build -o bin/itunes . # CLI tool
go build -o bin/mcp-itunes ./mcp-server # MCP server
go build -o bin/itunes-migrate ./cmd/migrate # Migration tool
# First-time setup or library refresh (~15-30 seconds)
./bin/itunes-migrate -from-script
# Validate existing database
./bin/itunes-migrate -validate
When to refresh: first install, library changes, metadata updates, or search issues.
# Search your music library
./bin/itunes search "jazz"
./bin/itunes search "Miles Davis"
./bin/itunes search --json "Miles Davis" # JSON output (used by the Vim plugin)
# Play tracks: play <playlist> [album] [track] [trackID]
./bin/itunes play "My Playlist" "" "" "B258396D58E2ECC9" # ID with playlist context
./bin/itunes play "" "Kind of Blue" "So What" # album + track name
# Current playback status
./bin/itunes now-playing # or: status
# Radio stations
./bin/itunes search-stations "jazz"
./bin/itunes list-stations
./bin/itunes add-station --name "Name" --url "itmss://..." [--genre g --description d --homepage url]
./bin/itunes update-station <id> [--name/--url/--genre/--description/--homepage ...]
./bin/itunes delete-station <id>
./bin/itunes import-stations stations.json
./bin/itunes export-stations stations.json
# Start MCP server (stdio transport)
./bin/mcp-itunes
Claude Desktop / Claude Code configuration:
{
"mcpServers": {
"itunes": {
"command": "/path/to/bin/mcp-itunes"
}
}
}
Search and play from inside Vim/Neovim via fzf:
Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
Plug 'chew-z/itunes.vim', { 'branch': 'main', 'rtp': 'vim-plugin' }
The plugin shells out to bin/itunes (auto-detected, or set g:itunes_bin).
See vim-plugin/README.md for configuration and
docs/VIM-PLUGIN.md for design details.
Music Library:
search_itunes — search library (<7ms FTS5 performance)search_advanced — filtered search (genre, artist, album, rating, starred, streaming)play_track — play with ID-based lookup and optional playlist contextnow_playing — current playback status and track inforefresh_library — rebuild database from Apple Music (~15–30 s, resource-intensive)Playlists:
list_playlists — all playlists with metadataget_playlist_tracks — tracks in a specific playlistRadio & Streams:
search_stations — find Apple Music radio stations by genre/nameplay_stream — play streaming URLs (itmss://, https://)EQ & Audio Output:
check_eq — current EQ status and available presetsset_eq — apply EQ presets (Rock, Jazz, Classical, …) or enable/disableget_output_device — current audio output (local/AirPlay)list_output_devices — available output devicesset_output_device — switch to local output (AirPlay selection must be manual)MCP Resources: itunes://database/stats, itunes://database/playlists
Best practice is ID-based playback with playlist context for continuous play:
{"track_id": "B258396D58E2ECC9", "playlist": "My Jazz Collection"}
Track IDs come from search results and are Apple Music persistent IDs, which avoids name-matching and encoding issues.
modernc.org/sqlite, no CGO)Developer docs live in docs/: architecture,
database & FTS5 internals,
JXA automation (including the bulk-fetch rule —
required reading before touching any JXA script), and the
Vim plugin.
├── itunes.go # CLI application (command dispatch + handlers)
├── mcp-server/ # MCP server (14 tools, grouped registration)
├── itunes/ # Core library: Client type, playback, EQ, JXA scripts
│ └── scripts/ # Embedded JXA automation scripts
├── database/ # SQLite + FTS5: schema, search, migrations
├── vim-plugin/ # Vim/Neovim frontend (fzf + CLI)
├── docs/ # Developer documentation
├── logging/ # zap logger setup
└── cmd/migrate/ # Database migration/validation tool
The core library exposes itunes.NewClient(logger) owning the database connection and search manager; playback and audio-control functions are package-level and take a context.Context.
./run_test.sh # go test -v ./...
./run_lint.sh # golangci-lint (zero findings expected)
./run_format.sh # gofmt -w .
# Or directly:
go test ./...
go test ./database -bench=BenchmarkSearch
Database issues:
./bin/itunes-migrate -from-script # Initialize/refresh
./bin/itunes-migrate -validate # Check status
Playback issues:
track_id from search results (most reliable)EQ/Audio issues:
Radio station playback:
itmss:// protocol URLs for playback; https:// URLs are homepage links onlyMIT License — see LICENSE file for details.
Thanks to Apple Music, SQLite FTS5, the MCP Protocol, and modernc.org/sqlite.
This is MCP server for playing from Apple Music Library
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Itunes.vim ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 This is MCP server for playing from Apple Music Library