Claude Music MCP
# 音乐 MCP 服务器
这是一个基于 Model Context Protocol (MCP) 的音乐管理服务器，提供音乐搜索、播放列表管理和音乐推荐功能。
## 功能特性
- 🔍 **音乐搜索**: 支持按歌曲名、艺术家、专辑搜索
- 📋 **播放列表管理**: 创建、管理和编辑播放列表
- 🎯 **音乐推荐**: 基于风格和心情的智能推荐
- 📊 **歌曲信息**: 获取详细的歌曲元数据
- ⭐ **评分系统**: 歌曲评分和播放统计
## 安装和运行
1. 安装依赖：
```bash
npm install
```
2. 构建项目：
```bash
npm run build
```
3. 启动服务器：
```bash
npm start
```
或者在开发模式下运行：
```bash
npm run dev
```
## 可用工具
### 1. search_music
搜索音乐库中的歌曲
- `query`: 搜索关键词
- `type`: 搜索类型 (song/artist/album/all)
- `limit`: 结果数量限制
### 2. get_song_info
获取特定歌曲的详细信息
- `songId`: 歌曲ID
### 3. create_playlist
创建新的播放列表
- `name`: 播放列表名称
- `description`: 播放列表描述（可选）
### 4. add_to_playlist
将歌曲添加到播放列表
- `playlistId`: 播放列表ID
- `songId`: 歌曲ID
### 5. get_playlist
获取播放列表信息和歌曲列表
- `playlistId`: 播放列表ID
### 6. list_playlists
列出所有播放列表
### 7. get_recommendations
获取音乐推荐
- `genre`: 音乐风格（可选）
- `mood`: 心情/氛围（可选）
- `limit`: 推荐数量
## 使用示例
在支持 MCP 的 AI 助手中，您可以这样使用：
- "搜索 Queen 的歌曲"
- "创建一个名为'我的最爱'的播放列表"
- "推荐一些摇滚音乐"
- "获取歌曲 ID 为 1 的详细信息"
## 技术栈
- TypeScript
- Model Context Protocol SDK
- Zod (数据验证)
- Node.js
## 许可证
MIT LicenseTDQS
Scored across 7 tools
Every tool has a clearly distinct purpose with no ambiguity. Tools like 'add_to_playlist', 'create_playlist', 'get_playlist', and 'list_playlists' each handle different aspects of playlist management, while 'search_music', 'get_song_info', and 'get_recommendations' cover distinct music discovery and information tasks. The descriptions reinforce these boundaries, making misselection unlikely.
All tool names follow a consistent verb_noun pattern using snake_case, such as 'add_to_playlist', 'create_playlist', 'get_playlist', 'get_recommendations', 'get_song_info', 'list_playlists', and 'search_music'. This predictable naming scheme enhances readability and usability, with no deviations in style or convention.
With 7 tools, this server is well-scoped for a music management domain. The count is appropriate, covering core operations like playlist management, music search, and recommendations without being overwhelming. Each tool earns its place by addressing a specific need, aligning with typical server sizes of 3-15 tools.
The tool surface is largely complete for music management, covering key operations like creating, listing, and getting playlists, adding songs, searching music, and getting recommendations. A minor gap exists in update or delete operations for playlists or songs, which agents might need to work around, but core workflows are well-supported.