音乐API交互服务器

一个用于与Apple Music API交互的服务器,提供搜索歌曲和生成播放链接的功能。

  • by akr4
  • Rust
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 akr4/applemusic-mcp-server

使用说明

苹果音乐MCP服务器

用于与Apple Music API交互的MCP服务器。此服务器提供用于搜索歌曲、生成播放链接的工具。

特性

  • 按标题、艺术家或专辑搜索歌曲
  • 为歌曲和播放列表生成深度链接
  • 简单的命令行界面
  • 使用模型上下文协议(MCP)与客户端交互

需求

  • 生锈(每晚,因为rmcp)
  • 具有Apple Music API访问权限的Apple Developer帐户
  • Apple Music API密钥(.p8文件)

安装

# Build the project
cargo install --path .

用法

Apple Music MCP服务器需要身份验证凭据才能访问Apple Music API。这些是通过命令行参数提供的。

cargo run -- --team-id YOUR_TEAM_ID --key-id YOUR_KEY_ID --private-key-path /path/to/AuthKey.p8

命令行参数

Usage: applemusic-mcp-server [OPTIONS]

Options:
--team-id <TEAM_ID>                    Apple Developer Team ID
--key-id <KEY_ID>                      Apple Music Key ID
--private-key-path <PRIVATE_KEY_PATH>  Path to the Apple Music private key file (.p8)
--storefront <STOREFRONT>              Storefront for Apple Music (e.g. us, jp) [default: jp]
-h, --help                                 Print help
-V, --version                              Print version

API工具

搜索歌曲

按标题、专辑名称或艺人名称搜索Apple Music中的歌曲。

参数:

  • query:(string)-搜索查询文本

退货:

  • 歌曲对象数组,包含标题、艺术家、专辑、持续时间和URL等详细信息

generatePlaybackLink

生成用于播放歌曲或播放列表的深度链接。

参数:

  • 要么 song_id 或 playlist_id 必须提供

退货:

  • 包含Apple Music URL的对象