mcp-qqmusic-test

This MCP server provides a test QQ Music search capability via MCP. It exposes a search function that accepts a keyword and returns a list of matching songs with metadata such as id, mid, name, pmid, subtitle, time_public, and title. The underlying search relies on the qqmusic-api-python backend for data retrieval. You can use the MCP interface to issue a search query and receive structured music results suitable for integration with other MCP components or clients.

To use it, ensure your MCP environment can run Python-based MCP servers via uv. Start the server using the provided uv command (as configured in mcp_config). Once running, you can invoke the search_music capability by calling the corresponding MCP method with a keyword (and optional page and num parameters). The response will be a JSON array of song objects containing essential fields like id, mid, name, title, and time_public, which you can display in your UI or pass to downstream services.

Prerequisites:

• Python 3.13 or compatible runtime
• uv (uv.x) installed and accessible in PATH

Installation steps:

1. Clone the repository: git clone https://github.com/Samge0/mcp-qqmusic-test-server.git cd mcp-qqmusic-test-server

2. Install dependencies (via uv): uv sync

3. Configure MCP integration:

   • Update the mcp_config in your MCP core to point to this server (as shown in the example).

4. Run the MCP server: uv --directory /path/to/mcp-qqmusic-test-server run main.py

Notes:

• Ensure network access to QQ Music API endpoints if required by the underlying qqmusic-api-python library.
• The example uses a local directory for the server files; adjust the path in mcp_config accordingly.

Tips:

• If you encounter Python dependency issues, verify that the environment has all required packages installed for qqmusic-api-python.
• The README indicates this is a testing/demo server; do not rely on it for production-grade music data.
• If the MCP core reports latency, consider increasing the page/num defaults in your client or implementing caching for repeated searches.
• Ensure that your environment variables (if any) required by the underlying libraries are properly configured (e.g., API keys or network proxy settings).