Spotify-OAuth-MCP-server - 连接AI与Spotify API，29种音乐工具模块化集成MCP协议

探索

Spotify OAuth MCP Server

一个连接AI助手与Spotify Web API的MCP服务器，提供音乐搜索、播放控制、歌单管理等29种工具，采用模块化设计和类型安全架构。

娱乐与媒体人工智能聊天机器人 #音乐控制 #AI集成 #Spotify #MCP服务 .TypeScript

评分 : 2分

下载量 : 5.5K

更新时间 : 2025-08-11

打开站点

安装

复制以下命令到你的Client进行配置

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/path/to/your/project/src/mcp/server.js"]
    }
  }
}

注意：您的密钥属于敏感信息，请勿与任何人分享。

🚀 Spotify MCP 服务器

这是一个全面的模型上下文协议（MCP） 服务器，它能让 AI 助手（如 Claude Desktop）与 Spotify Web API 实现无缝集成。该服务器使 AI 助手能够通过一个结构良好、类型安全的接口与 Spotify 的音乐流媒体服务进行交互。

🚀 快速开始

1. 克隆并安装

git clone <repository-url>
cd Spotify-OAuth-MCP-server
npm install

2. 获取 Spotify 访问令牌

3. 构建并启动

# 构建 TypeScript 代码
npm run build

# 启动 MCP 服务器
npm start

# 开发模式，支持自动重新加载
npm run dev

✨ 主要特性

🛠️ 29 种综合工具，涵盖 7 个类别：

专辑（4 种工具）：专辑信息和新发行内容
艺术家（6 种工具）：艺术家数据、热门曲目和发现功能
曲目（8 种工具）：曲目详情、歌词和库管理
播放列表（10 种工具）：完整的播放列表管理和发现功能
播放（10 种工具）：全面的播放器控制和设备管理
用户（1 种工具）：用户个人资料信息
搜索（2 种工具）：通用搜索和搜索即播放功能

🏗️ 清晰的架构：

模块化设计：基于功能的工具组织方式
类型安全：完全采用 TypeScript 实现，并使用 Zod 进行验证
可复用组件：通用的模式构建器避免了代码重复
自动注册：工具会自动被发现并注册
错误处理：全面的错误管理，提供详细的错误信息

🔧 开发者体验：

易于扩展：添加新工具的模式简单
代码可维护：关注点分离清晰
文档完善：模式定义具有自文档性
调试方便：详细的日志记录和错误报告

📦 安装指南

按照快速开始部分的步骤进行操作：

克隆仓库并安装依赖。
获取 Spotify 访问令牌。
构建并启动服务器。

💻 使用示例

基础用法

将此 MCP 服务器与 Claude Desktop 集成后，你可以使用自然语言命令，例如：

"播放我的发现周报播放列表"
"搜索披头士乐队的歌曲"
"将这首歌添加到我的收藏"
"跳到下一首曲目"
"创建一个名为 '清晨氛围' 的新播放列表"
"搜索带有轻松音乐的播放列表"
"显示我本月的热门艺术家"
"当前正在播放什么？"
"将这首歌添加到我的播放队列"
"获取我最近播放的曲目"
"显示这首歌的歌词"
"获取纯文本歌词以进行分析"

🔧 Claude Desktop 集成

要在 Claude Desktop 中使用此 MCP 服务器，将其添加到你的 MCP 配置中：

macOS/Linux：`~/Library/Application Support/Claude/claude_desktop_config.json`

Windows：`%APPDATA%\Claude\claude_desktop_config.json`

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/path/to/your/project/src/mcp/server.js"]
    }
  }
}

📚 详细文档

🏗️ 项目架构

src/
├── mcp/
│   ├── server.ts              # 主 MCP 服务器入口点
│   ├── helpers/
│   │   └── utils.ts          # 实用函数和辅助工具
│   ├── schemas/
│   │   └── common.ts         # 可复用的模式构建器
│   └── tools/
│       ├── index.ts          # 工具注册表和注册系统
│       ├── albums.ts         # 与专辑相关的工具（4 种工具）
│       ├── artists.ts        # 与艺术家相关的工具（6 种工具）
│       ├── tracks.ts         # 与曲目相关的工具（8 种工具）
│       ├── playlists.ts      # 播放列表管理工具（10 种工具）
│       ├── playback.ts       # 播放控制工具（10 种工具）
│       ├── user.ts           # 用户个人资料工具（1 种工具）
│       └── search.ts         # 搜索功能工具（2 种工具）
└── spotify.ts                # Spotify Web API 服务类