Beatport MCP Server

Beatport MCP服务器

_请注意：；这项工作仍在进行中！！_

一种MCP（模型上下文协议）服务器，提供对Beatport API的访问，用于音乐发现和数据检索。

特性

• 轻松身份验证：简单的用户名/密码身份验证
• 全面Beatport API：访问曲目、艺术家、标签、发行、图表等
• 柔性运输：支持stdio和HTTP传输
• 基于OpenAPI构建：利用官方的Beatport OpenAPI规范

安装

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

认证

⚠️ 重要：Beatport的API需要不公开的OAuth2凭据。您有三个选择：

选项1：手动令牌（推荐）

1. 获取您的代币:

node get-token.js  # Shows detailed instructions

1. 设置令牌:

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服务器”的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：不记名代币（或 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服务器）
• --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后，您可以使用以下命令：

Search for tech house tracks released in 2024
Find all releases on Drumcode label
Get details for artist "Charlotte de Witte"
List top 10 tracks in the Techno chart
Find tracks with BPM between 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许可证-有关详细信息，请参阅许可证文件。

贡献

问题和拉取请求欢迎！该项目建立在 @ivotoby/openapi-mcp-server 包裹。