Tunetank Mcp

Tunetank MCP 服务

Tunetank 音乐和音效目录现已作为 MCP 服务提供 — 因此，任何 AI 助手（Claude、ChatGPT、Cursor 等）都能为视频、广告、播客或直播找到合适的免版税曲目或音效。

你可以这样提问：“找一首适合 YouTube 片头、时长约 60 秒的活力摇滚曲目”，或 “一段时长不到 2 秒的呼啸音效”。助手会搜索 Tunetank 的真实目录，并提供试听链接和 tunetank.com 上的曲目页面。

• 🎵 根据情绪、流派、主题、艺术家、名称和目标时长（± 容差）搜索音乐
• 🔊 根据类别和时长搜索音效（SFX）
• 📚 浏览流派、情绪、主题和精选播放列表
• ▶️ 每条结果都包含音频试听 URL和规范曲目页面（https://tunetank.com/track/<id>-<slug>/）
• 🆓 完全免费 — 无需 API 密钥、身份验证或注册以解除速率限制。只读。

---

服务

端点	https://mcp.tunetank.com
传输方式	Streamable HTTP（JSON-RPC 2.0）
身份验证	无（公开，只读）
费用	免费

---

设置

将任何支持 MCP 的客户端指向上述端点。以下是常见客户端的示例：

Claude Desktop / Claude.ai（连接器）

添加自定义连接器并填写 URL：

https://mcp.tunetank.com

或者，通过配置文件（claude_desktop_config.json）使用 mcp-remote 桥接：

{
  "mcpServers": {
    "tunetank": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tunetank.com"]
    }
  }
}

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "tunetank": {
      "url": "https://mcp.tunetank.com"
    }
  }
}

VS Code / 其他客户端

任何支持远程（HTTP）MCP 服务的客户端 — 只需使用 URL https://mcp.tunetank.com。对于仅支持 stdio 的客户端，可通过 npx -y mcp-remote https://mcp.tunetank.com 进行桥接。

---

工具

工具	参数	返回内容
search_music	query、name、artist、genre、mood、theme、duration、tolerance、limit	曲目：名称、艺术家、时长、bpm、试听 URL、曲目页面 URL、流派/情绪/主题
search_sfx	query、category、duration、tolerance、limit	音效：名称、时长、试听 URL、波形
list_genres	—	所有音乐流派（id、name、alias）
list_moods	—	所有音乐情绪（id、name、alias）
list_themes	—	所有音乐主题（id、name、alias）
list_playlists	limit	精选播放列表（名称、描述、曲目数量）

参数说明

• query （search_music）— 自由文本；匹配曲目名称或艺术家名称。
• genre / mood / theme — 接受名称/别名（例如 "rock"、"happy"）或数字 id（来自 list_* 工具）。
• duration — 目标时长，单位为秒。
• tolerance — duration 前后的允许偏差，单位为秒（默认值为 5）。例如：duration: 60, tolerance: 10 → 时长在 50 秒到 70 秒之间的曲目。
• category （search_sfx）— SFX 类别名称或 id。
• limit — 结果数量上限（默认值为 20，最大为 50；播放列表默认值为 50，最大为 200）。

所有字符串筛选条件均采用不区分大小写的部分匹配。只返回已发布的曲目/SFX。

---

示例

“活力摇滚，约 60 秒，适合片头”

{
  "name": "search_music",
  "arguments": { "genre": "rock", "mood": "energetic", "duration": 60, "tolerance": 10, "limit": 5 }
}

“一段不到 2 秒的短促呼啸音效”

{
  "name": "search_sfx",
  "arguments": { "query": "whoosh", "duration": 1.5, "tolerance": 1.5 }
}

曲目结果示例

{
  "id": 2270,
  "name": "Adventures",
  "artist": "A Himitsu",
  "duration": 138,
  "bpm": 120,
  "url": "https://tunetank.com/track/2270-adventures/",
  "preview": "https://…/preview.mp3",
  "genres": ["Pop"],
  "moods": ["Happy", "Inspiring"],
  "themes": ["Vlog"]
}

---

试用（原始 JSON-RPC）

该传输方式严格遵循规范，因此请同时包含 Content-Type 和 Accept 标头：

# List available tools
curl -s https://mcp.tunetank.com \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Search music
curl -s https://mcp.tunetank.com \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_music","arguments":{"mood":"happy","duration":60,"tolerance":10,"limit":3}}}'

---

许可

所有音乐均可免费用于个人及非商业用途。

其他用途（商业项目、广告、营利内容、客户项目等），请访问 tunetank.com 并查看许可条款。

---

关于

音乐和音效来自 Tunetank — 为创作者提供的免版税音频。此 MCP 服务是一个发现渠道：它会返回试听内容和曲目页面，方便你收听并在 tunetank.com 获取曲目。下载和许可均在网站上办理。

如有疑问或遇到问题，请联系 [email protected]。