MusicPlayerMcpServer 0.1.0-beta

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of MusicPlayerMcpServer. 
{
  "servers": {
    "MusicPlayerMcpServer": {
      "type": "stdio",
      "command": "dnx",
      "args": ["MusicPlayerMcpServer@0.1.0-beta", "--yes"]
    }
  }
}
This package contains an MCP Server. The server can be used in VS Code by copying the generated JSON to your VS Code workspace's .vscode/mcp.json settings file. 
dotnet tool install --global MusicPlayerMcpServer --version 0.1.0-beta
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local MusicPlayerMcpServer --version 0.1.0-beta
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=MusicPlayerMcpServer&version=0.1.0-beta&prerelease
                    


                    

                
nuke :add-package MusicPlayerMcpServer --version 0.1.0-beta

MusicPlayerMcp

MusicPlayerMcp is a simple Model Context Protocol (MCP) server that exposes a stdio-based interface for controlling local music playback. It is intended to be used by MCP‑aware AI assistants (such as GitHub Copilot) or any client that can speak the protocol over standard input/output.

The tool set is intentionally small and focused: play a track (by URL or search query) and stop playback. There is no extra configuration or user interface; the server runs in the background and interacts via MCP messages.

Available MCP Tools

All interactions happen through MCP requests on stdin/stdout.

playSong

Requests playback of a song. The argument may be a full YouTube URL or a natural-language query (title/artist).

  • Input: a single string containing the song query or URL.
  • Behavior: resolves the query, downloads the audio, and begins local playback.
  • Response: confirmation that playback has started, or an error message.

stopPlayback

Stops any currently playing audio.

  • Input: none.
  • Behavior: halts playback immediately.
  • Response: confirmation that playback was stopped.

⚠️ Only one track can play at a time; a new playSong request replaces any existing audio.

Usage

  1. Launch the server executable. It listens for MCP messages on its standard input and writes responses to standard output.
  2. Send an MCP request with the desired tool name and parameters.
  3. Read the response on stdout to know when the action completes.

From an MCP‑capable client (such as Copilot), the assistant simply invokes the tool by name. Example prompts:

  • "Play 'Bohemian Rhapsody' for me." → triggers playSong with query Bohemian Rhapsody.
  • "Stop the music." → triggers stopPlayback.

Notes

  • The server uses youtube.com as the source for audio; it does not require the user to install or configure a browser.
  • It is a stdio tool and has no GUI.
  • Designed for quick control via natural language; implementation details are intentionally hidden from users.

Enjoy seamless, AI‑driven local music playback!

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
0.1.0-beta 24 3/7/2026

- Initial beta release (0.1.0-beta).
- Support for search and play musics.
- Support for stop musics.
- Integration with MCP-compliant clients (Visual Studio, Claude Desktop).