MCP QQ音乐测试服务器

这是一个通过MCP（模块化控制协议）提供QQ音乐搜索功能的测试服务器。该服务器允许您使用关键词搜索音乐曲目并返回相关歌曲信息。

此演示仅用于测试和学习目的，其中音乐检索使用了qqmusic-api-python。

功能

• 支持使用关键词通过MCP搜索音乐曲目

环境需求

• 已安装uv
• Python 3.13

安装指南

1. 克隆此仓库

   git clone https://github.com/Samge0/mcp-qqmusic-test-server.git
   

2. 安装依赖项：

   uv sync
   

使用说明

配置mcp：

{
  "mcpServers": {
    "mcp-qqmusic-test-server": {
        "command": "uv",
        "args": [
            "--directory",
            "{在这里放置你的本地目录}/mcp-qqmusic-test-server",
            "run",
            "main.py"
        ]
    }
  }
}

测试搜索音乐

<details> <summary>使用关键词搜索音乐曲目>></summary>

功能: search_music

参数

• keyword (字符串, 必填): 搜索关键词或短语
• page (整数, 可选): 分页的页码（默认值：1）
• num (整数, 可选): 返回结果的最大数量（默认值：20）

返回值:

返回一个包含以下属性的对象数组：

• id: 歌曲ID
• mid: 音乐ID
• name: 歌曲名称
• pmid: 播放音乐ID
• subtitle: 歌曲副标题
• time_public: 发布时间
• title: 歌曲标题

示例响应:

[
  {
    "id": "123456",
    "mid": "001Qu4I30eVFYb",
    "name": "七里香",
    "pmid": "",
    "subtitle": "",
    "time_public": "2004-08-03",
    "title": "七里香"
  }
]

</details>