Music Library
A powerful Model Context Protocol (MCP) server that provides intelligent access to your local music collection through advanced metadata management, album type classification, and comprehensive analytics.
What is Music Library?
Music Library is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to powerful model context protocol (mcp) server that provides intelligent access to your local music collection through advanced metadata management, album type classification, and comprehensive analytic...
A powerful Model Context Protocol (MCP) server that provides intelligent access to your local music collection through advanced metadata management, album type classification, and comprehensive analytics.
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A powerful Model Context Protocol (MCP) server that provides
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx musicConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Music Library
The Music Library MCP Server gives AI assistants intelligent access to a local music collection, offering 10 tools and 3 resources for scanning folder structures, reading and writing band metadata, classifying albums by type (studio, live, compilation, EP), running advanced 13-parameter album searches, and generating collection-wide analytics—all without any external API or streaming service.
Prerequisites
- Python 3.8 or higher
- A local music library organized in folders by artist/band
- The MUSIC_ROOT_PATH environment variable pointing to your music directory
- pip for installing Python dependencies (or Docker for containerized use)
- Claude Desktop or another MCP-compatible client
Clone the repository
Download the Music MCP Server source code from GitHub.
git clone https://github.com/gorums/music-mcp-server.git
cd music-mcp-serverInstall dependencies using the automated setup script
Run the provided setup script to install all required Python packages in one step.
python scripts/setup.pyAlternative: install dependencies manually
If the setup script is unavailable, install requirements directly with pip.
pip install -r requirements.txtConfigure Claude Desktop with your music path
Add the server to Claude Desktop config, passing your music library root path as an environment variable. On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json.
{
"mcpServers": {
"music": {
"command": "python",
"args": ["/absolute/path/to/music-mcp-server/main.py"],
"env": {
"MUSIC_ROOT_PATH": "/Users/yourname/Music",
"CACHE_DURATION_DAYS": "30",
"LOG_LEVEL": "INFO"
}
}
}
}Alternative: run with Docker
Use Docker to run the server in a container, mounting your music directory.
docker build -t music-mcp .
docker run -v "/path/to/your/music:/music" -e MUSIC_ROOT_PATH=/music music-mcpRestart Claude Desktop and scan your library
After restarting Claude Desktop, ask it to scan your music folders. The first scan builds the metadata cache.
Music Library Examples
Client configuration
Complete Claude Desktop config with the music server pointing to a local library path.
{
"mcpServers": {
"music": {
"command": "python",
"args": ["/Users/yourname/music-mcp-server/main.py"],
"env": {
"MUSIC_ROOT_PATH": "/Users/yourname/Music",
"CACHE_DURATION_DAYS": "30",
"LOG_LEVEL": "INFO"
}
}
}
}Prompts to try
Example prompts for exploring and managing your music collection through Claude.
- "Scan my music library and tell me how many bands and albums you find"
- "List all studio albums by Radiohead in my collection"
- "Find all live albums released after 2010 in my library"
- "Which bands in my collection have the most albums?"
- "Analyze my collection and give me statistics on album types (studio vs live vs compilation)"Troubleshooting Music Library
scan_music_folders returns zero results or an empty library
Verify MUSIC_ROOT_PATH is set to the correct absolute path and that the directory exists. The server expects music organized in subdirectories by artist name. Run `ls $MUSIC_ROOT_PATH` to confirm the path is reachable.
Metadata reads are slow on the first run
The initial scan reads file system metadata for every folder and can take several minutes for large libraries. After the first run, results are cached for CACHE_DURATION_DAYS (default 30 days). Subsequent queries will be fast.
Permission denied errors when reading music files
The Python process running the server needs read access to your music directory. On macOS, grant Full Disk Access or Files and Folders access to Terminal (or the app running Claude) in System Settings > Privacy & Security.
Frequently Asked Questions about Music Library
What is Music Library?
Music Library is a Model Context Protocol (MCP) server that powerful model context protocol (mcp) server that provides intelligent access to your local music collection through advanced metadata management, album type classification, and comprehensive analytics. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Music Library?
Follow the installation instructions on the Music Library GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Music Library?
Music Library works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Music Library free to use?
Yes, Music Library is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Music Library Alternatives — Similar File Systems Servers
Looking for alternatives to Music Library? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
★ 14.1k📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
★ 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
★ 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
★ 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
★ 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Music Library in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Music Library?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.