MCP QQ Music Test Server

by Samge0

MCP QQ音乐测试服务器

这是一个通过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" ] } } }

测试搜索音乐

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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

A server that provides QQ Music search functionality through the Modular Control Protocol, allowing users to search for music tracks by keyword and retrieve song information.

  1. 功能特点
    1. 环境要求
      1. 安装说明
        1. 使用方法
          1. 测试搜索音乐

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          An MCP server that allows AI models to control YouTube Music playback through Google Chrome by searching and playing songs using song and artist names.
          Last updated -
          2
          JavaScript
          MIT License
          • Apple
        • A
          security
          F
          license
          A
          quality
          A server that connects Claude with Spotify, allowing users to control playback, search content, get information about tracks/albums/artists/playlists, and manage the Spotify queue.
          Last updated -
          4
          273
          Python
          • Apple
        • -
          security
          F
          license
          -
          quality
          A Model Context Protocol (MCP) server that provides access to the Beatport Developer API, allowing Claude to interact with music data from Beatport's electronic music catalog.
          Last updated -
          Python
          • Apple
        • A
          security
          F
          license
          A
          quality
          A server that enables interaction with YouTube data through the Model Context Protocol, allowing users to search videos, retrieve detailed information about videos/channels, and fetch comments.
          Last updated -
          12
          6
          JavaScript

        View all related MCP servers

        ID: z8qr41v7h8