MCP QQ音乐测试服务器

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

该demo仅用于测试和学习目的，其中音乐检索使用的是qqmusic-api-python。

功能特点

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

Related MCP server: MCP Server for Qdrant

环境要求

已安装了uv
Python 3.13

安装说明

克隆此仓库
git clone https://github.com/Samge0/mcp-qqmusic-test-server.git
安装依赖：
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": "七里香" } ]

One-click Deploy

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Tools

search_music

MCP QQ Music Test Server