Skip to main content

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

Metadata

Release files for iflow-mcp_samge0_mcp-qqmusic-test-server 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_samge0_mcp-qqmusic-test-server 0.1.0
File Size Uploaded
iflow_mcp_samge0_mcp_qqmusic_test_server-0.1.0.tar.gz 3.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_samge0_mcp-qqmusic-test-server 0.1.0
File Interpreter ABI Platform
iflow_mcp_samge0_mcp_qqmusic_test_server-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 6.7 kB

Release files / iflow_mcp_samge0_mcp_qqmusic_test_server-0.1.0.tar.gz

Download URL iflow_mcp_samge0_mcp_qqmusic_test_server-0.1.0.tar.gz
Size 3.0 kB
Tags Source
SHA-256 checksum
How to use checksums
69b5ab76d7787d15f64555f50fcd96444712b81a725c2c8776b3edea975f668b
BLAKE2b-256 checksum
How to use checksums
10e9f84fdd987331f64be5f1e1f18e79470ddfa38f8b06fdeee31ae4b0c04b7b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.8

Release files / iflow_mcp_samge0_mcp_qqmusic_test_server-0.1.0-py3-none-any.whl

Download URL iflow_mcp_samge0_mcp_qqmusic_test_server-0.1.0-py3-none-any.whl
Size 3.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a30af5f8d9a0eece568a5a3506066ee2661dc247c19de310ce7c31c296a3cdfa
BLAKE2b-256 checksum
How to use checksums
d7c8c012501ef71ba50f3aa79af65bebaad48919591e80e932e1afa82d3f3f26
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.8

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page