内容
# 亚马逊音乐 MCP 服务器
通过克劳德桌面使用模型上下文协议控制亚马逊音乐播放。
## 功能
- ▶️ 播放/暂停当前曲目
- ⏭️ 跳到下一曲目
- 🔍 搜索并播放歌曲、艺术家或专辑
- 🎵 与任何亚马逊音乐订阅配合使用
## 先决条件
- Python 3.10 或更高版本
- 谷歌浏览器
- 亚马逊音乐账户
- 克劳德桌面应用程序
## 安装
### 1. 通过 pip 安装（即将推出）
```bash
pip install amazon-music-mcp
```
### 2. 手动安装
```bash
# 克隆仓库
git clone https://github.com/mk-8/amazon-music-mcp.git
cd amazon-music-mcp
# 创建虚拟环境
python3 -m venv .venv
source .venv/bin/activate # 在 Windows 上：.venv\Scripts\activate
# 安装依赖项
pip install -e .
```
## 设置
### 1. 配置克劳德桌面
将以下内容添加到您的克劳德桌面配置文件中：
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"amazon-music": {
"command": "python",
"args": ["-m", "amazon_music_mcp"]
}
}
}
```
或如果使用手动安装：
```json
{
"mcpServers": {
"amazon-music": {
"command": "/path/to/your/.venv/bin/python",
"args": ["/path/to/amazon-music-mcp/server.py"]
}
}
}
```
### 2. 启动 Chrome 进行远程调试
**macOS/Linux**：
```bash
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
--remote-debugging-port=9222 \
https://music.amazon.com &
```
**Windows**：
```cmd
"C:\Program Files\Google\Chrome\Application\chrome.exe" ^
--remote-debugging-port=9222 ^
https://music.amazon.com
```
### 3. 重启克劳德桌面
完全退出并重启克劳德桌面，以便更改生效。
## 使用方法
配置完成后，您可以要求克劳德控制您的音乐：
- "播放当前曲目"
- "暂停音乐"
- "跳到下一曲目"
- "搜索并播放 Bohemian Rhapsody"
- "播放 Taylor Swift 的歌曲"
## 可用命令
| 命令 | 描述 |
|---------|-------------|
| `play` | 恢复播放 |
| `pause` | 暂停当前曲目 |
| `next_track` | 跳到下一首歌 |
| `search_and_play` | 搜索并播放艺术家、歌曲或专辑 |
## 故障排除
### Chrome 连接问题
确保 Chrome 运行远程调试：
```bash
# 检查端口 9222 是否正在使用
lsof -i :9222 # macOS/Linux
netstat -ano | findstr :9222 # Windows
```
### 服务器未出现在克劳德中
1. 验证配置文件路径是否正确
2. 检查 Python 路径是否指向正确的解释器
3. 完全重启克劳德桌面
4. 检查克劳德桌面日志中的错误
### Playwright/浏览器错误
- 确保您已登录亚马逊音乐
- 保持 Chrome 窗口打开
- 不要关闭亚马逊音乐标签页
## 开发
### 运行测试
```bash
python3 test_server.py
```
### 项目结构
```
amazon-music-mcp/
├── amazon_music_mcp/
│ ├── __init__.py
│ ├── __main__.py
│ ├── server.py
│ └── music.py
├── pyproject.toml
├── requirements.txt
├── README.md
├── LICENSE
├── .gitignore
```
## 工作原理
1. MCP 服务器通过 Chrome DevTools 协议连接到 Chrome
2. Playwright 自动化亚马逊音乐网页界面
3. 克劳德桌面通过 MCP 协议与服务器通信
4. 命令被翻译成浏览器自动化操作
## 贡献
欢迎贡献！请随时提交拉取请求。
## 许可证
MIT 许可证 - 请参阅 LICENSE 文件了解详情
## 支持
- 报告问题：[GitHub 问题](https://github.com/mk-8/amazon-music-mcp/issues)
- 文档：[完整文档](https://github.com/mk-8/amazon-music-mcp/wiki)
## 路线图
- [ ] PyPI 包发布
- [ ] 音量控制
- [ ] 播放列表管理
- [ ] 当前歌曲信息
- [ ] 队列管理
- [ ] 支持 Spotify、YouTube Music
- [ ] Windows/Linux 测试
## 作者
Meet Kavathiya - [@meetkavathiya](https://github.com/mk-8/amazon-music-mcp)
## 致谢
- 使用 [模型上下文协议](https://modelcontextprotocol.io/) 构建
- 浏览器自动化由 [Playwright](https://playwright.dev/) 提供
