返回 MCP 目录
public公开dns本地运行

emotion_playlist_mcp

Emotion Playlist MCP是一个基于MCP的工具,根据用户情绪状态生成Spotify播放列表。它利用Brave搜索和Spotify集成,自动创建符合心情的音乐播放列表。

article

README

🚀 情绪播放列表 MCP

情绪播放列表 MCP 是一款基于 MCP 的实用工具,它能依据用户当下的情绪状态,自动生成专属的 Spotify 歌单。该工具借助 Brave Search MCP 服务器,精准查找与用户情绪相关的歌曲,并通过集成 Spotify MCP 服务器,实现歌单的自动创建与填充,为用户带来个性化的音乐体验。

🚀 快速开始

克隆仓库

git clone https://github.com/yourusername/emotion_playlist_mcp.git
cd emotion_playlist_mcp

设置环境

你可以选择使用 uv 来快速设置环境:

uv init

若你想手动设置,可按以下步骤操作:

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

配置环境变量

在项目根目录下创建一个 .env 文件,并按如下格式填写信息:

SPOTIFY_CLIENT_ID=你的 Spotify 客户端 ID
SPOTIFY_CLIENT_SECRET=你的 Spotify 客户端密钥
SPOTIFY_REDIRECT_URI=http://127.0.0.1:8888/callback  # 必须与 Spotify 开发者应用程序中的重定向 URI 相同
BRAVE_API_KEY=你的 Brave API 密钥

注意:Spotify 令牌可以在 Spotify 开发者网站上找到,且使用该工具需要你拥有 Spotify 高级账户。

生成 Spotify 的授权令牌

运行以下命令来生成 Spotify 的授权令牌:

python3 orchestrator/tools/spotify_auth.py

安装 MCP 服务器

使用以下命令安装 MCP 服务器:

mcp install main.py --name EmotionPlaylistMCP   

✨ 主要特性

  • 支持用户输入自然语言描述自己的情绪。
  • 能够将用户输入的情绪信息细化为详细的搜索短语。
  • 借助 Brave 搜索引擎,精准搜索与细化后情绪相匹配的歌曲建议。
  • 自动利用搜索到的歌曲信息,在 Spotify 上创建并填充歌单。

🤝 贡献

欢迎大家对本项目进行复刻、修改,并提交拉取请求。让我们携手合作,让基于情绪的音乐推荐变得更加智能!

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端