锤子音乐网锤子音乐网
Model Context Protocol

锤子音乐 MCP

让 Claude、ChatGPT 等 AI 助手直接搜索、试听、下载锤子音乐网曲库。一行配置，AI 即可调用完整的音乐检索能力。

接入指南直接在网页上搜索 ›

什么是锤子音乐 MCP？

MCP（Model Context Protocol） 是让 AI 助手与外部数据源、工具通信的开放标准。锤子音乐 MCP 是一个基于该标准的音乐服务， 把锤子音乐网现成的搜索、详情、歌词、试听、下载等能力封装成一组「工具（Tools）」，供任何支持 MCP 的客户端调用。

你无需复制粘贴链接，也无需切换网页——在对话里用自然语言描述需求，AI 即可直接查到歌曲、播放或给出下载地址。

提供的工具

search_musicq, limit

按歌名、歌手、专辑关键词搜索歌曲

GET /api/v1/search?q=

suggestq

搜索联想与补全，用于输入实时提示

GET /api/v1/search/suggest?q=

get_songid

获取歌曲详情：歌手、专辑、可用音源平台

GET /api/v1/songs/:id

get_lyricsid

获取歌曲歌词

GET /api/v1/songs/:id/lyrics

get_play_urlid

获取在线试听播放地址

GET /media/play/:id

get_download_urlid

获取高品质下载地址

GET /media/download/:id

get_chartstype

获取榜单（download-weekly 下载周榜 / popular 热门榜）

GET /api/v1/charts/:type

get_latest—

获取最新入库歌曲

GET /api/v1/latest

使用示例

在接入 MCP 后，把下面这些话直接发给你的 AI 助手即可：

  • “帮我找周杰伦的《晴天》，并给出下载链接。”
  • “搜 10 首适合跑步的快节奏英文歌。”
  • “这首歌的歌词是什么？（给出歌曲名）”
  • “本周下载榜前 5 名是哪些？”
  • “把这首歌的试听地址发给我。”

安装与接入

Claude Code（命令行）

claude mcp add --transport http chuizi-music https://chuizi.org/mcp

Claude Desktop（配置文件）

编辑 claude_desktop_config.json，加入以下服务：

{
  "mcpServers": {
    "chuizi-music": {
      "type": "http",
      "url": "https://chuizi.org/mcp"
    }
  }
}

✓ 端点 https://chuizi.org/mcp 已上线（Streamable HTTP，无需鉴权）。配置后即可在对话中调用上述工具。

常见问题

MCP 和普通网页搜索有什么区别？

网页搜索需要你自己点开页面、复制链接；MCP 让 AI 直接调用工具，在对话中完成查找、试听、下载，无需离开当前窗口。

支持哪些 AI 客户端？

任何支持 MCP 的客户端均可接入，例如 Claude Desktop、Claude Code，以及兼容 MCP 协议的第三方客户端。

收费吗？

锤子音乐网的检索与下载本身免费；MCP 只是把这些能力开放给 AI 助手调用。