内容
# 歌趣宝 MCP 连接器
用于从 www.gequbao.net 搜索音乐并获取播放网址的 MCP 服务器。
## 安装 uv
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
## 使用方法（Claude / Cursor / Windsurf）
只需在您的 MCP 配置文件中添加以下条目。保存后，重启您的客户端；服务器将通过 uv 自动下载并启动。
{
"mcpServers": {
"gequbao": {
"command": "uv",
"args": [
"tool",
"run",
"--from",
"git+https://github.com/cgitato/gequbao-mcp.git",
"gequbao_mcp"
]
}
}
}
## 工具
### 按完整标题搜索
按关键词搜索歌曲。
**参数：**
- `keyword`（字符串，必填）：歌曲名称。
- `limit`（整数，可选）：最大结果数，默认为 5。
- `enrich`（布尔值，可选）：获取完整标题，默认为 false。
**返回：**
{
"ok": true,
"enriched": false,
"songs": [
{
"title": "**",
"artist": "**",
"song_id": "**",
"detail_url": "https://www.gequbao.net/**",
"full_title": "**"
}
]
}
### 获取音乐网址
获取直接 MP3 播放网址。
**参数：**
- `detail_url`（字符串，必填）：歌曲详情页网址。
**返回：**
{
"ok": true,
"audio":{
"title": "**",
"url": "https://**.mp3",
"time_total": "**"
}
}
## 本地开发
bash
git clone https://github.com/cgitato/gequbao-mcp.git
cd gequbao-mcp
uv sync
uv run gequbao_mcp
启动后，可以通过本地 MCP 客户端的 stdio 连接服务器。
## 免责声明
本工具仅用于学习和技术研究，请勿用于商业目的。
播放链接来源于第三方网站，其稳定性和可用性取决于上游提供商。
如果访问受限或反爬虫措施发生变化，可能需要更新解析器。
