QQ Music Search
这是一个通过MCP（模块化控制协议）提供QQ音乐搜索功能的测试服务器。该服务器允许您使用关键词搜索音乐曲目，并返回相关歌曲信息。
What is QQ Music Search?
QQ Music Search is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 这是一个通过mcp（模块化控制协议）提供qq音乐搜索功能的测试服务器。该服务器允许您使用关键词搜索音乐曲目，并返回相关歌曲信息。
这是一个通过MCP（模块化控制协议）提供QQ音乐搜索功能的测试服务器。该服务器允许您使用关键词搜索音乐曲目，并返回相关歌曲信息。
This server falls under the APIs and Search & Data Extraction categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- 这是一个通过MCP（模块化控制协议）提供QQ音乐搜索功能的测试服务器。该服务器允许您使用关键词搜索音乐曲目，并返回相关歌
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-qqmusic-testConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use QQ Music Search
The QQ Music Search MCP Server provides a lightweight MCP interface for searching Tencent's QQ Music catalog by keyword. It exposes a single search_music tool that accepts a keyword plus optional pagination parameters and returns song metadata including IDs, titles, subtitles, and release dates — suitable for music discovery and integration testing workflows.
Prerequisites
- Python 3.13 installed
- uv package manager installed (curl -LsSf https://astral.sh/uv/install.sh | sh)
- Git for cloning the repository
- Claude Desktop or another MCP client
Clone the repository
Clone the QQ Music MCP server repository to your local machine.
git clone https://github.com/Samge0/mcp-qqmusic-test-server.git
cd mcp-qqmusic-test-serverInstall dependencies with uv
Use uv to sync the project dependencies as defined in the pyproject.toml file.
uv syncTest the server manually
Run the server once manually to confirm it starts without errors before connecting it to Claude.
uv run main.pyConfigure Claude Desktop
Add the MCP server entry to Claude Desktop's configuration file. Replace the directory path with the absolute path where you cloned the repository.
{
"mcpServers": {
"mcp-qqmusic-test-server": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/mcp-qqmusic-test-server",
"run",
"main.py"
]
}
}
}Verify with a music search
Restart Claude Desktop and ask it to search for a song. The search_music tool should return matching results from QQ Music.
QQ Music Search Examples
Client configuration
Claude Desktop configuration running the QQ Music server via uv from the cloned project directory.
{
"mcpServers": {
"mcp-qqmusic-test-server": {
"command": "uv",
"args": [
"--directory",
"/home/user/mcp-qqmusic-test-server",
"run",
"main.py"
]
}
}
}Prompts to try
Example prompts for searching QQ Music by artist name, song title, or genre keywords.
- "Search QQ Music for songs by Jay Chou and show me the first 10 results"
- "Find the song 'Qing Fei De Yi' on QQ Music and give me its song ID and release date"
- "Search QQ Music for popular Mandopop tracks from the keyword '流行' and list their titles"
- "Look up the song ID for 'Yi Jian Mei' on QQ Music so I can use it in my playlist app"Troubleshooting QQ Music Search
uv sync fails with Python version errors
This project requires Python 3.13. Run: uv python install 3.13 to install the correct version via uv, then retry uv sync.
Server starts but search returns empty results
QQ Music's API may throttle requests from non-mainland-China IPs. Try a VPN exit node in mainland China or test with very popular artist names like '周杰伦' (Jay Chou) which are more likely to return results regardless of region.
Claude cannot find the MCP server
Ensure the --directory path in the args array is an absolute path, not a relative one. Check that main.py exists at that location and that uv is installed and accessible at the command path your shell uses.
Frequently Asked Questions about QQ Music Search
What is QQ Music Search?
QQ Music Search is a Model Context Protocol (MCP) server that 这是一个通过mcp（模块化控制协议）提供qq音乐搜索功能的测试服务器。该服务器允许您使用关键词搜索音乐曲目，并返回相关歌曲信息。 It connects AI assistants to external tools and data sources through a standardized interface.
How do I install QQ Music Search?
Follow the installation instructions on the QQ Music Search GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with QQ Music Search?
QQ Music Search works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is QQ Music Search free to use?
Yes, QQ Music Search is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
QQ Music Search Alternatives — Similar APIs Servers
Looking for alternatives to QQ Music Search? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.
Kong
★ 43.4k🦍 The API and AI Gateway
API Mega List
★ 5.4kThis GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪
Fetch
★ 5.4kFetch web content and convert to markdown for AI consumption
Fusio
★ 2.1kSelf-Hosted API Management for Builders
Korean Law
★ 1.8k국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools
RuleGo
★ 1.5k⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.
Browse More APIs MCP Servers
Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up QQ Music Search in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use QQ Music Search?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.