Content
# 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.
