music

This MCP server provides music playback capabilities. It exposes a set of tools for searching and controlling music: query_music to search for songs, play_music to start playback, play_by_index to play a specific song from the search results by its position, and stop_music, pause_music, and unpause_music to control playback state. To use it, connect to the MCP environment you’re using (Claude, VS Code, or your automation layer) and invoke these commands against the music-mcp-server. The server is designed to be simple to integrate with other MCP-enabled tools, allowing you to search for tracks and manage playback without leaving your workflow.

Prerequisites:

• A runtime that supports UV (e.g., uvx) or Python if you choose the Python pathway.
• Access to install dependencies as needed by your environment.

Installation steps (recommended via UV/uvx):

1. Ensure uvx is available in your environment. If you don’t have UV installed, follow the UV installation guide for your OS.
2. Clone the repository: git clone https://github.com/JXiuFen/music-mcp-server.git
3. Run the MCP server with UV in your environment: uvx music-mcp-server This will start the music MCP server and expose its tooling via MCP commands.

If you prefer to run via Python, install Python and run the provided module (as indicated in your Claude/VS Code configuration examples):

1. Ensure Python is installed and accessible as python.
2. Start the server using: python music-mcp-server

Note: The exact command might vary slightly depending on how you mount or expose the server in your environment. The README examples show uvx as the recommended entry point for this project.

Tips and common considerations:

• The available tools are: query_music, play_music, play_by_index, stop_music, pause_music, unpause_music. Use query_music to build a list of candidate tracks before playing.
• If your environment uses VS Code integration or a Claude setup, you can embed the uvx command and the server name (music-mcp-server) in your mcp.json or equivalent configuration for seamless startup.
• Ensure network access where the music data or streaming endpoints reside, and verify that any required API keys or library permissions are configured (if your search or streaming backend requires them).
• If you encounter issues starting the server, check that uvx is correctly resolving the music-mcp-server entry point and that the working directory contains the correct executable or module entry points.
• The configuration example uses the server name music-mcp-server; you can rename it in your environment, but update the config accordingly.