音乐数据库API服务

一个远程MCP服务器,将MusicBrainz API作为工具暴露给AI助手,运行在Cloudflare Workers上。

  • by AjjayK
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AjjayK/MusicDB

使用说明

音乐DB

遥控器 主控程序 暴露的服务器 MusicBrainz API 作为人工智能助手的工具。在Cloudflare Workers上运行。

实时端点

https://musicdb-mcp.musicdb.workers.dev/mcp

添加到您的AI助手

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "musicdb": {
      "url": "https://musicdb-mcp.musicdb.workers.dev/mcp"
    }
  }
}

Claude.ai

首选 设置>集成>添加自定义集成 并输入:

https://musicdb-mcp.musicdb.workers.dev/mcp

任何MCP客户端

使用以下命令将MCP客户端指向上面的URL 流式HTTP 运输。

工具

核心工具

工具 说明
musicbrainz_lookup 通过MusicBrainz ID(MBID)查找任何实体
musicbrainz_browse 浏览链接到另一个实体的实体(例如艺术家的所有版本)
musicbrainz_search 使用Lucene查询语法进行搜索(例如。 artist:radiohead)
musicbrainz_lookup_by_resource 按ISRC、ISWC或光盘ID查找

便利工具

工具 说明
musicbrainz_get_tracklist 带有持续时间和学分的发布格式化曲目列表
musicbrainz_get_genres 实体的类型和社区标签
musicbrainz_get_release_events 全球发布日期和国家
musicbrainz_url_lookup 从Spotify、维基百科、Discogs链接查找MusicBrainz实体
musicbrainz_get_discography 按类型组织的完整艺术家唱片
musicbrainz_get_credits 录制或发行的制作学分和关系
musicbrainz_get_artist_relationships 乐队成员、合作者和外部链接
musicbrainz_find_covers 音乐作品的所有录音(封面、现场版本)
musicbrainz_compare_releases 两个版本的并排比较

示例提示

  • “Radiohead的成员是谁?”
  • “查找Abbey Road的曲目列表”
  • “肯德里克·拉马尔属于哪些流派?”
  • “比较这张专辑的美国和英国版本”
  • “寻找哈利路亚的封面版本”
  • “此Spotify链接指向哪个MusicBrainz条目?”

发展

npm install
npm run dev              # Start local dev server on port 8787
npm run deploy           # Deploy to Cloudflare Workers

使用MCP检查员进行本地测试:

npx @modelcontextprotocol/inspector
# Enter http://localhost:8787/mcp as the server URL

技术栈

  • 运行时:Cloudflare员工
  • MCP-SDK: @modelcontextprotocol/sdk + agents (Cloudflare传输)
  • 验证:佐德
  • 缓存:Cloudflare Cache API(24小时查找、6小时浏览、1小时搜索)
  • 速率限制:上游请求之间的最小间隔为1.05s+在503/429上重试

许可证

麻省理工学院