使用说明

🎵 MusicAI-克劳德+Spotify音乐推荐系统

由Claude AI和Spotify支持的未来音乐推荐系统，可根据您的心情和音乐偏好提供个性化的歌曲推荐。直接在浏览器中播放预览，无需离开应用程序！

✨ 特性

🎭 基于情绪的推荐：从8种不同的情绪（快乐、悲伤、精力充沛、冷静、有动力、放松、聚会、心碎）中选择，以获得个性化的音乐建议
🤖 AI驱动算法：Claude AI分析你的音乐品味和情绪，以创建类似于Spotify的《发现周刊》的基于算法的推荐
🎧 在浏览器中播放：直接在浏览器中播放30秒预览-无需打开Spotify链接
🔍 Spotify搜索：直接搜索歌曲、艺术家和曲目
💬 克劳德聊天：与Claude AI聊天，进行音乐相关对话
🎨 现代用户界面：简洁、未来主义的设计，具有玻璃形态效果和流畅的交互
📱 响应式设计：在台式机和移动设备上运行良好

🚀 快速开始

先决条件

Node.js（v16或更高版本）
npm或纱线
无烟煤API键
Spotify开发者帐户

安装

克隆存储库

git clone https://github.com/yourusername/musicAI-mcps.git
cd musicAI-mcps

安装依赖项

# Install root dependencies
npm install

# Install client dependencies
cd client && npm install && cd ..

设置环境变量

创建一个 .env 根目录中的文件：

# Anthropic API Key (required)
ANTHROPIC_API_KEY=your_anthropic_api_key_here

# Spotify API Credentials (required)
SPOTIFY_CLIENT_ID=your_spotify_client_id_here
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret_here

# Server Port (optional, defaults to 3000)
PORT=3000

获取API密钥

无烟煤API密钥：
- 访问拟人控制台
- 注册或登录
- 导航到API密钥部分
- 创建新的API密钥
- 复制并粘贴到 .env 文件
Spotify API证书：
- 首选 Spotify开发者仪表板
- 使用您的Spotify帐户登录
- 点击“创建应用”
- 填写应用程序详细信息
- 复制客户端ID和客户端密码
- 粘贴到 .env 文件

运行应用程序

# Run both client and server concurrently
npm run dev

# Or run them separately:
# Terminal 1 - Server
npm run server

# Terminal 2 - Client
npm run client

在浏览器中打开
- 客户：http://localhost:5173
- 服务器：http://localhost:3000

📖 用法

基于情绪的推荐

选择 “情绪建议” 模式（默认）
从8个可用选项中选择您当前的心情
（可选）输入您的音乐偏好（流派、最喜欢的艺术家等）
点击 “获取基于算法的推荐”
Claude AI将分析您的情绪和偏好
通过以下方式获得个性化歌曲推荐：
- 播放预览按钮（30秒预览）
- 直接Spotify链接
- 相册艺术品
- 人工智能为每项建议生成解释

Spotify搜索

选择 “Spotify搜索” 模式
键入歌曲名称、艺术家或曲目
通过预览播放获得即时结果

克劳德聊天

选择 “与克劳德聊天” 模式
问克劳德任何关于音乐的事
获得AI驱动的响应

🏗️ 项目结构

musicAI-mcps/
├── client/                 # React frontend
│   ├── src/
│   │   ├── App.jsx        # Main application component
│   │   ├── App.css        # Styles
│   │   └── main.jsx       # Entry point
│   ├── public/            # Static assets
│   ├── package.json       # Client dependencies
│   └── vite.config.js     # Vite configuration
├── server/                 # Express backend
│   └── server.js          # MCP server implementation
├── package.json           # Root package configuration
├── .env                   # Environment variables (create this)
├── .gitignore            # Git ignore rules
└── README.md             # This file

🔌 API终点

服务器端点

GET /status -健康检查端点

{
  "status": "ok",
  "service": "Claude + Spotify MCP Server"
}

POST /invoke -工具调用端点

{
  "tool": "mood_recommendations" | "spotify_search" | "claude_chat",
  "input": "string or JSON string"
}

可用工具

mood推荐：根据心情获取基于AI的音乐推荐
spotify_search：在Spotify上搜索曲目
克劳德聊天：与Claude AI聊天

🛠️ 使用的技术

前端：
- 反应18+
- 顺风 CSS
- 维特
- 阿西奥斯
后端：
- Node.js
- Express.js
- API人类克劳德
- Spotify Web API

🎨 详细功能

情绪选择

从8种精心策划的情绪中选择，每种情绪都有自己的配色方案：

😊 快乐
😢 悲伤
🔥 精力充沛的
😌 放松
💪 有动力的
😴 放松的
🎉 聚会
💔 心碎

基于算法的推荐

该系统使用Claude AI来：

分析您的音乐偏好
了解你目前的心情
生成类似于Spotify算法的推荐
为每首歌曲的选择提供解释

在浏览器中播放

直接在浏览器中播放30秒预览
无需打开Spotify（除非您想要完整曲目）
流畅的音频控制
底部的“正在播放”栏

🐛 故障排除

常见问题

API密钥错误：

确保你的 .env 文件位于根目录中
验证API密钥是否正确且处于活动状态
检查您的文件夹中是否没有多余的空间 .env 文件

CORS错误：

服务器包括CORS中间件-这应该会自动工作
如果问题仍然存在，请检查服务器是否在端口3000上运行

端口冲突：

更改 PORT 在你的 .env 如果3000已在使用中
在中更新客户端API URL App.jsx 如果你改变端口

找不到模型错误：

该应用程序使用 claude-3-haiku-20240307 默认情况下
如果您有权访问其他型号，请在中更新型号名称 server/server.js

没有可用的预览：

某些曲目没有来自Spotify的预览URL
点击“Spotify”按钮，在Spotify中打开完整曲目

📝 脚本

npm run dev      # Run both client and server
npm run server   # Run server only
npm run client   # Run client only
npm start        # Run server only (alias)

🤝 贡献

欢迎投稿！请随时提交拉取请求。

分叉存储库
创建功能分支(git checkout -b feature/AmazingFeature)
提交您的更改(git commit -m 'Add some AmazingFeature')
推到分支(git push origin feature/AmazingFeature)
打开拉取请求

📄 许可证

该项目根据ISC许可证获得许可。

🙏 致谢

Anthropic 克劳德AI
声破天用于Spotify Web API
反应和顺风 CSS 令人惊叹的UI框架

📧 联系

如有疑问或支持，请在GitHub上发布问题。

由以下材料制成❤️ 使用Claude AI和Spotify