MCP QQ音乐测试服务器 - 音乐搜索功能的MCP协议实现

功能特点

强大的音乐搜索能力，简单的集成方式

关键词搜索

支持使用任意关键词搜索音乐曲目，快速找到您想要的歌曲。

详细信息返回

返回歌曲ID、名称、副标题、发布时间等完整的歌曲元数据信息。

MCP 协议支持

完全兼容 MCP 协议标准，易于集成到各种支持 MCP 的客户端应用中。

分页支持

支持分页搜索功能，可以灵活控制返回结果的数量和页码。

简单配置

通过简单的 JSON 配置即可启用，无需复杂的设置过程。

开源免费

完全开源，基于 MIT 许可证，可自由使用和修改。

快速开始

只需几个简单步骤即可开始使用

1

克隆仓库

克隆项目到本地目录

2

安装依赖

使用 uv 同步项目依赖

3

配置 MCP

在 MCP 配置文件中添加服务器配置

4

开始搜索

使用 search_music 函数开始搜索音乐

MCP 配置示例

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

环境要求

确保您的系统满足以下要求

Python 3.13

最新 Python 版本

uv 包管理器

快速 Python 包安装工具

API 文档

使用 search_music 函数搜索音乐

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

常见问题

快速解答您的疑问

MCP 是什么？

MCP（Modular Control Protocol，模块化控制协议）是一种用于在不同系统之间进行通信和控制的标准化协议。本项目使用 MCP 协议来提供音乐搜索功能。

如何安装 uv 包管理器？

uv 是一个快速的 Python 包管理器。您可以从 GitHub - uv 获取安装说明。

这个项目可以商用吗？

这个项目仅供测试和学习目的使用。QQ音乐的相关服务请遵守其官方使用条款。

搜索结果的数量有限制吗？

是的，您可以使用 num 参数控制返回结果的数量，默认值为 20。

MCP QQ音乐 测试服务器