M

MCP QQ音乐搜索服务器

@Samge0/mcp-qqmusic-test-server
3 Stars 839 次浏览 Samge0 更新于 2026-08-23

通过模块化控制协议提供QQ音乐搜索功能的服务器，允许用户通过关键词搜索音乐曲目并获取歌曲信息。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

可用工具 （1 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

search_music 3 个参数 需填 1 项

Search for music tracks Args: keyword: Search keyword or phrase page: Page number for pagination (default: 1) num: Maximum number of results to return (default: 20) Returns: List of music tracks matching the search criteria

必填参数：keyword

服务介绍

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"
        ]
    }
  }
}

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": "七里香"
  }
]
查看源码 项目主页