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

2. 设置令牌：

export BEATPORT_ACCESS_TOKEN="your_token_here"
beatport-mcp-server

选项 2：用户名/密码（目前无法使用）

export BEATPORT_USERNAME="[email protected]"
export BEATPORT_PASSWORD="yourpassword"
beatport-mcp-server

选项 3：联系 Beatport

发送邮件至 [email protected]，申请“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 后，你可以使用以下命令：

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 许可证——详情请参阅 LICENSE 文件。

贡献

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