Beatport MCP Server

请注意；这仍然是一个正在进行的工作！！

这是一个提供对Beatport API访问以进行音乐发现和数据检索的MCP（模型上下文协议）服务器。

特性

• 简单的认证：使用用户名/密码进行简单认证
• 完整的Beatport API：访问曲目、艺术家、唱片公司、发行、排行榜等
• 灵活的传输方式：支持stdio和HTTP传输方式
• 基于OpenAPI构建：利用官方的Beatport OpenAPI规范

安装

npm install -g @ivotoby/beatport-mcp-server

认证

⚠️ 重要：Beatport的API需要OAuth2凭证，这些凭证不是公开可用的。您有三种选择：

方案1：手动令牌（推荐）

1. 获取您的令牌：

node get-token.js  # 显示详细说明

2. 设置令牌：

export BEATPORT_ACCESS_TOKEN="your_token_here"
beatport-mcp-server

方案2：用户名/密码（当前无法工作）

export BEATPORT_USERNAME="your@email.com"
export BEATPORT_PASSWORD="yourpassword"
beatport-mcp-server

方案3：联系Beatport

发送邮件至 engineering@beatport.com 请求“Beatport MCP Server”的OAuth2凭证

HTTP传输

beatport-mcp-server --transport http --port 3000

配置选项

• --username, -u：Beatport用户名/邮箱（或 BEATPORT_USERNAME）
• --password, -p：Beatport密码（或 BEATPORT_PASSWORD）
• --transport, -t：传输类型：stdio（默认）或 http
• --accessToken, -a：Bearer令牌（或 BEATPORT_ACCESS_TOKEN）
• --refreshToken, -r：刷新令牌（或 BEATPORT_REFRESH_TOKEN）
• --port：HTTP端口（默认：3000，用于HTTP传输）
• --host：HTTP主机（默认：127.0.0.1，用于HTTP传输）
• --path：HTTP端点路径（默认：/mcp，用于HTTP传输）
• --name, -n：服务器名称（默认：beatport-mcp-server）
• --version, -v：服务器版本（默认：1.0.0）
• --tools：工具模式：all（默认）或 dynamic
• --tool：仅导入指定的工具ID或名称
• --tag：仅导入具有指定OpenAPI标签的工具
• --resource：仅导入位于指定资源路径前缀下的工具
• --operation：仅导入针对指定HTTP方法的工具
• --disable-abbreviation：禁用工具名称优化

可用工具

服务器会自动从Beatport API端点生成MCP工具：

目录

• catalog-artists-list：搜索并列出艺术家
• catalog-artists-retrieve：获取艺术家详情
• catalog-tracks-list：搜索并列出曲目
• catalog-releases-list：搜索并列出发行
• catalog-labels-list：搜索并列出唱片公司
• catalog-genres-list：列出音乐流派

排行榜与播放列表

• catalog-charts-list：浏览排行榜
• catalog-playlists-list：浏览播放列表

搜索与发现

• 按流派、唱片公司、艺术家、BPM、键、发行日期过滤
• 支持分页
• 曲目和发行的详细元数据

在Claude中的示例用法

一旦连接到Claude Desktop，您可以使用如下命令：

搜索2024年发布的科技浩室曲目
查找Drumcode唱片公司的所有发行
获取艺术家"Charlotte de Witte"的详情
列出Techno排行榜的前十名曲目
查找BPM在120-130之间的曲目

认证说明

• 使用Beatport的OAuth2资源所有者密码凭据流程
• 需要有效的Beatport账户
• 令牌会自动管理和刷新
• 不需要处理Beatport客户端凭证（内部处理）

开发

git clone https://github.com/ivo-toby/beatport-mcp-server
cd beatport-mcp-server
npm install
npm run build
npm run start

许可证

MIT许可证 - 详情见LICENSE文件。

贡献

欢迎提交问题和拉取请求！此项目基于 @ivotoby/openapi-mcp-server 包构建。