MCP QQ音乐测试服务器

基本能力

产品定位

MCP QQ音乐测试服务器是一个用于测试和学习目的的QQ音乐搜索服务，通过MCP协议提供音乐搜索功能。

核心功能

• 支持使用关键词搜索音乐曲目
• 返回包含歌曲ID、音乐ID、歌曲名称、副标题、发布时间等信息的歌曲列表

适用场景

• 测试和学习MCP协议的使用
• 开发需要音乐搜索功能的应用程序

工具列表

• qqmusic-api-python：用于音乐检索的Python API

常见问题解答

无

使用教程

使用依赖

• 已安装uv
• Python 3.13

安装教程

1. 克隆此仓库 bash git clone https://github.com/Samge0/mcp-qqmusic-test-server.git
2. 安装依赖： bash uv sync

调试方式

配置mcp：

{
  "mcpServers": {
    "mcp-qqmusic-test-server": {
        "command": "uv",
        "args": [
            "--directory",
            "{put your local dir here}/mcp-qqmusic-test-server",
            "run",
            "main.py"
        ]
    }
  }
}

测试搜索音乐

函数： 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": "七里香"
  }
]

许可证

None