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