AI导哈

音乐播放协议服务器

MusicPlayerMcp 是一个简单的模型上下文协议（MCP）服务器，通过标准输入/输出接口控制本地音乐播放，适用于支持MCP的AI助手或客户端。

  • by IseduardoRezende
  • C#
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 IseduardoRezende/MusicPlayerMcp

使用说明

音乐播放器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）

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

相关 MCP