Gequbao MCP Connector

MCP server for searching music and getting play URLs from www.gequbao.net.

Install uv first

Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1| iex"

macOS / Linux: bash curl -LsSf https://astral.sh/uv/install.sh| sh

Usage (Claude / Cursor / Windsurf)

Simply add the following entry to your MCP configuration file. Once saved, restart your client; the server will be downloaded and started automatically via uv.

{ "mcpServers": { "gequbao": { "command": "uv", "args": [ "tool", "run", "--from", "git+https://github.com/cgitato/gequbao-mcp.git", "gequbao_mcp" ] } }
}

Tools

search_with_full_title

Search songs by keyword.

Params:

• keyword (string, required): Song name.
• limit (int, optional): Max results, default 5.
• enrich (bool, optional): Fetch full title, default false.

Returns: { "ok": true, "enriched": false, "songs": [ { "title": "", "artist": "", "song_id": "", "detail_url": "https://www.gequbao.net/", "full_title": "**" } ] }

get_music_url

Get direct MP3 play URL.

Params:

• detail_url (string, required): Song detail page URL.

Returns: { "ok": true, audio:{ "title": "", "url": "https://.mp3", "time_total": "**" } }

Local Dev

bash git clone https://github.com/cgitato/gequbao-mcp.git cd gequbao-mcp uv sync uv run gequbao_mcp

Once started, the server can be connected via stdioin your local MCP client.

Disclaimer

This tool is intended for learning and technical research only. Do not use it for commercial purposes. Playback links are sourced from third‑party websites; their stability and availability depend on the upstream provider. If access is restricted or anti‑scraping measures change, parser updates may be required.