Music Player MCP

音乐播放器Mcp

MusicPlayerMcp 很简单 模型上下文协议（MCP）服务器 它公开了一个基于stdio的接口，用于控制本地音乐播放。它旨在供支持MCP的AI助手（如GitHub Copilot）或任何可以通过标准输入/输出说出协议的客户端使用。

该工具集有意地小而专注：播放一首曲目（通过Youtube URL或搜索查询）并停止播放。没有额外的配置或用户界面；服务器在后台运行，并通过MCP消息进行交互。

Nuget软件包仓库：https://www.nuget.org/packages/MusicPlayerMcpServer/

Docker包仓库：https://hub.docker.com/r/eduardorezende01/musicplayermcp

______________________________________________________________________

可用的MCP工具

所有交互都是通过stdin/stdout上的MCP请求进行的。此服务器公开了两个基于stdio的工具，Copilot（或任何支持MCP的客户端）可以直接调用：

search_and_play_song

这个工具 必须 每当用户要求播放或听音乐时，都可以使用。它接受YouTube URL或自然语言歌曲/艺术家查询；如果输入不是URL，服务器将自动搜索YouTube。该工具解析查询，下载音频，并开始本地播放。

• 输入： 包含歌曲查询或YouTube URL的单个字符串。
• 行为： 解析查询、下载音频并开始播放。新请求将替换任何现有音频。
• 答复： 确认播放已开始或显示错误消息。

有效提示示例：

• play Let It Happen by Tame Impala
• please play Bohemian Rhapsody
• play https://youtube.com/...

stop_song

这个工具 必须 每当用户要求停止或取消音乐时使用。它会立即停止任何当前播放。

• 输入： 没有。
• 行为： 停止播放。
• 答复： 确认歌曲已停止。

有效提示示例：

• Stop the music
• please cancel the song
• stop the audio

一次只能播放一首曲目；发行 search_and_play_song 当音乐已经播放时，将替换当前曲目。

______________________________________________________________________

用法

• 1°选项-复制并粘贴到您的收藏夹.mcp服务器（例如VS Code、Claude Desktop）

{
  "servers": {
    "MusicPlayerMcpServer": {
      "type": "stdio",
      "command": "dnx",
      "args": ["MusicPlayerMcpServer@0.1.0-beta", "--yes"]
    }
  }
}

2°选项-复制并粘贴到您的收藏夹.mcp服务器（例如VS Code、Claude Desktop）

{
  "servers": {
    "MusicPlayerMcpDocker": {
      "command": "docker",
      "args": [
       "run",
        "-i",
        "--rm",
        "eduardorezende01/musicplayermcp"
      ]
    }
  }
}

从支持MCP的客户端（如Copilot），助手只需按名称调用工具。示例提示：

• _“为我演奏《波西米亚狂想曲》。”_ → 触发器 search_and_play_song 带查询 Bohemian Rhapsody.
• _“停止音乐。”_ → 触发器 stop_song.

______________________________________________________________________

备注

• 服务器使用youtube.com作为音频源；它不需要用户安装或配置浏览器。
• 它是一个 stdio工具 并且没有GUI。
• 对于 “DNX” 命令。必须安装NET 10运行时：https://dotnet.microsoft.com/en-us/download/dotnet/10.0
• 设计用于通过自然语言进行快速控制；实现细节故意对用户隐藏。
• 音频文件被下载到Temp文件夹中（例如windows->C:\\Users\\x\\AppData\\Local\\Temp\\MusicPlayerMcp）

享受无缝、人工智能驱动的本地音乐播放！