Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Qqmusic Test Server

FreeNot checked

This is a test server that provides QQ Music search functionality through MCP (Modular Control Protocol). The server allows you to search for music tracks using keywords and returns relevant song information.

GitHubEmbed

About

This is a test server that provides QQ Music search functionality through MCP (Model Context Protocol). The server allows you to search music tracks using keywords and returns relevant song information.

README

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

🌐 在线宣传页 — 可视化了解功能特性与工作流程

该demo仅用于测试和学习目的,其中音乐检索使用的是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",
            "{put your local dir here}/mcp-qqmusic-test-server",
            "run",
            "main.py"
        ]
    }
  }
}

image

image

测试搜索音乐

使用关键词搜索音乐曲目>>

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

from github.com/Samge0/mcp-qqmusic-test-server

Installing Qqmusic Test Server

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/Samge0/mcp-qqmusic-test-server

FAQ

Is Qqmusic Test Server MCP free?

Yes, Qqmusic Test Server MCP is free — one-click install via Unyly at no cost.

Does Qqmusic Test Server need an API key?

No, Qqmusic Test Server runs without API keys or environment variables.

Is Qqmusic Test Server hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Qqmusic Test Server in Claude Desktop, Claude Code or Cursor?

Open Qqmusic Test Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Qqmusic Test Server with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs