Skip to main content
Glama
Sign In
gequbao

gequbao

by cgitato
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

Related MCP server: qq-music-mcp

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.

Available Tools

2 tools
get_music_urlA

✅ Agent 单曲播放地址获取工具

【使用方式】 get_music_url(detail_url: str) -> dict

【返回结构】 { "ok": true, audio:{ "title": "xxx", "url": "https://xxx.mp3", "time_total": "03:00" } }

【失败返回】 { "ok": false, "mp3_url": None, "error_code": "", "error": "" }

【Agent 使用约束】 ✅ 只能在确认目标歌曲后调用 ✅ 每次只调用一首 ❌ 禁止批量调用 ❌ 禁止在搜索阶段调用

Inputs: detail_url (required).

search_with_full_titleA

✅ Agent 音乐搜索工具

【使用方式】 search_with_full_title( keyword: str, limit: int, enrich: bool = False ) -> dict

【参数描述】 keyword: 搜索关键词 limit: 返回结果数量限制，默认5 enrich: 是否补全完整歌名（含 Live / 现场信息），默认false

【返回结构】 { "ok": true, "enriched": false, "songs": [ { "title": "七里香", "artist": "周杰伦", "song_id": "4194", "detail_url": "https://www.gequbao.com/music/4194", "full_title": "" } ] }

【失败返回】 { "ok": false, "songs": [], "error_code": "search_failed" }

【Agent 使用约束】 ✅ 可多次调用 ✅ 结果不合适时可增大 limit ✅ 结果不合适时可开启 enrich=True ❌ 禁止在搜索阶段调用播放接口

Inputs: keyword (required), limit, enrich.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.6/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools serve clearly distinct purposes: search for songs and retrieve a playback URL. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    Both tool names follow a consistent snake_case and verb_noun pattern: search_with_full_title and get_music_url. No naming conflicts or style mixing.

    Tool Count3/5

    With only 2 tools, the server is minimal. While it covers a basic search-to-play workflow, the number feels slightly thin for a music service. However, it is not extreme and matches the narrow scope.

    Completeness4/5

    The core workflow of searching for songs and retrieving audio URLs is covered. Minor gaps exist, such as no separate tool for song metadata only, but agents can work around by using the search result data.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • LLM Jukebox MCP Server

      jabberjabberjabber
      A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables LLMs to search, download, and extract information from YouTube music videos, converting them to high-quality MP3 files.
      GPL 3.0

    • qq-music-mcp

      wangkezun
      A
      license
      A
      quality
      D
      maintenance
      Integrates QQ Music API with MCP, enabling LLMs to search music, retrieve song details, lyrics, and playback URLs.
      10
      4
      MIT

    • Music Player MCP

      Irislan0723
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables in-chat music playback by searching song names or specifying Netease song IDs, returning playable music cards with cover, lyrics, and a temporary audio proxy. It relies on a user-configured Netease-compatible API and supports custom card colors.
      6
      MIT