# music MCP server

这是一个播放歌曲的mcp服务

### 工具列表

- `query_music` - 搜索相关歌曲.
- `play_music` - 播放歌曲
- `play_by_index` - 播放搜索到的第几首歌曲
- `stop_music` - 停止播放歌曲
- `pause_music` - 暂停播放歌曲
- `unpause_music` - 恢复播放歌曲

## 安装

### 使用uv

使用 [`uv`](https://docs.astral.sh/uv/) 时无需进行特定安装。我们将使用 [`uvx`](https://docs.astral.sh/uv/guides/tools/) 直接运行 *music-mcp-server*。

### 下载源码

```bash
git clone https://github.com/JXiuFen/music-mcp-server.git
```

## 配置

### Claude.app配置

在您的 Claude 设置中添加：

<details>
<summary>使用 uvx</summary>

```json
{
  "mcpServers": {
    "music-mcp-server": {
      "command": "uvx",
      "args": ["music-mcp-server"]
    }
  }
}
```
</details>

<details>
<summary>使用 pip</summary>

```json
{
  "mcpServers": {
    "music-mcp-server": {
      "command": "python",
      "args": ["music-mcp-server"]
    }
  }
}
```
</details>

### VSCode配置

如需快速安装，请使用下面的其中一个一键安装按钮。...

[![Install with UV in VS Code](https://img.shields.io/badge/VS_Code-UV-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=time&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-time%22%5D%7D) [![Install with UV in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-UV-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=time&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-time%22%5D%7D&quality=insiders)


对于手动安装，请在 VS Code 中的“用户设置（JSON）”文件中添加以下 JSON 块。您可以通过按下 `Ctrl + Shift + P` 并输入“偏好设置：打开用户设置（JSON）”来完成此操作。

您也可以选择将其添加到工作区中名为 `.vscode/mcp.json` 的文件中。这样您就可以与他人共享这些配置了。

> 请注意，使用 `mcp.json` 文件时需要设置 `mcp` 键。

<details>
<summary>使用 uvx</summary>

```json
{
  "mcp": {
    "servers": {
      "time": {
        "command": "uvx",
        "args": ["music-mcp-server"]
      }
    }
  }
}
```
</details>