内容
# Spotify MCP Tool
一个强大的工具,将 Spotify API 与 Google 的 Gemini AI 结合,提供音乐洞察、推荐和分析。
## 特性
### Spotify 数据访问
- 用户个人资料信息
- 播放列表和曲目
- 顶级曲目和艺术家
- 最近播放的曲目
- 新发行的音乐
### AI 驱动的洞察 (Gemini)
- 全面的听歌习惯分析
- 个性化曲目推荐
- 播放列表洞察和分析
- 关于播放列表的问题回答
- 音乐发现建议
- 基于情绪的播放列表生成
## 安装
1. 克隆代码库:
```bash
git clone https://github.com/pradeepjung45/spotify_mcp.git
cd spotify_mcp
```
2. 创建虚拟环境并安装依赖:
```bash
python -m venv venv
source venv/bin/activate # 在 Windows 上: venv\Scripts\activate
pip install -r requirements.txt
```
3. 设置环境变量:
在根目录创建一个 `.env` 文件,内容如下:
```
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
SPOTIFY_REDIRECT_URI=http://127.0.0.1:8000/callback
GEMINI_API_KEY=your_gemini_api_key
```
## 使用
### CLI 工具
该项目包括一个命令行界面,用于与 Spotify 和 Gemini AI 进行交互:
1. 使用 Spotify 进行身份验证:
```bash
python mcp_tools.py auth_url
```
这将提供一个 URL,您可以在浏览器中打开。授权后,您将被重定向到一个带有代码参数的回调 URL。
2. 使用代码完成身份验证:
```bash
python mcp_tools.py auth_url --code YOUR_CODE_HERE
```
3. 获取您的用户个人资料:
```bash
python mcp_tools.py user_profile
```
4. 获取您的播放列表:
```bash
python mcp_tools.py playlists
```
5. 获取您听歌习惯的 AI 分析:
```bash
python mcp_tools.py listening_analysis
```
6. 获取 AI 驱动的曲目推荐:
```bash
python mcp_tools.py track_recommendations
```
7. 获取特定播放列表的洞察:
```bash
python mcp_tools.py playlist_insights --playlist-id YOUR_PLAYLIST_ID
```
8. 提问关于播放列表的问题:
```bash
python mcp_tools.py playlist_question --playlist-id YOUR_PLAYLIST_ID --question "这个播放列表的整体情绪是什么?"
```
9. 获取音乐发现建议:
```bash
python mcp_tools.py music_discovery
```
10. 获取基于情绪的播放列表建议:
```bash
python mcp_tools.py mood_playlist --mood happy
```
### FastAPI 服务器
该项目还包括一个 FastAPI 服务器,通过 Web 界面访问相同的功能:
1. 启动服务器:
```bash
python -m uvicorn app.main:app --host 0.0.0.0 --port 8000
```
2. 打开浏览器并导航到 `http://localhost:8000`
3. 点击“使用 Spotify 登录”进行身份验证
4. 访问各种 Spotify 数据和 AI 洞察的端点
## MCP 集成
该工具旨在作为 MCP (Model Context Protocol) 工具与 Claude Desktop 一起使用。一旦 Claude Desktop 可用,您可以使用以下命令安装该工具:
```bash
mcp install mcp_tools.py
```
## 项目结构
- `app/` - FastAPI 应用
- `routers/` - API 路由处理程序
- `services/` - Spotify 和 Gemini 的服务类
- `config.py` - 配置设置
- `main.py` - FastAPI 应用入口
- `mcp_tools.py` - MCP 工具和 CLI 接口
## 需求
- Python 3.8+
- Spotify 开发者账户
- Google Gemini API 密钥
## 许可证
MIT
## 致谢
- [Spotify Web API](https://developer.spotify.com/documentation/web-api/)
- [Google Gemini AI](https://ai.google.dev/gemini-api)
- [FastAPI](https://fastapi.tiangolo.com/)
- [FastMCP](https://github.com/anthropics/fastmcp)
连接信息
猜你喜欢
X视频文案提取
X / Twitter 视频文案提取 MCP Server — 专注解析 X 平台公开视频链接(x.com / twitter.com status...
cc-switch
跨平台的Claude Code、Codex和Gemini CLI一体化助手。
awesome-mcp-servers
一组 MCP 服务器。
Git
一个用于Git自动化和交互的模型上下文协议服务器。
oh-my-opencode
背景代理 · 精心挑选的代理,如 oracle、librarians、frontend engineer · 预构建工具,如 LSP/AST ·...
TrendRadar
TrendRadar:30秒内为您提供真实新闻的热点助手。