mcpField
M
musicport

musicport

本地服务
github.com/CloudCorpRecords游戏娱乐02 周前更新
代码仓库

关于 musicport

musicport 是面向 Spotify 搜索、播放和播放列表操作的 MCP 服务与命令行工具，通过提供的访问令牌调用 Spotify Web API。

主要功能

  1. 01搜索 Spotify
  2. 02播放控制
  3. 03列出和获取播放列表
  4. 04创建播放列表并添加曲目
  5. 05列出已保存曲目

适用场景

  1. 01搜索 Spotify 曲库
  2. 02控制当前播放
  3. 03查看或编辑播放列表

MCP 相关

它将 Spotify 搜索、播放、用户资料、播放列表和已保存曲目操作作为 MCP 工具提供。服务直接使用 `SPOTIFY_ACCESS_TOKEN`，不包含 OAuth 授权或刷新流程。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-musicport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/musicport"
      ]
    }
  }
}
启动命令npx -y @reneturcios/musicport

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/musicport0.1.0
ocighcr.io/cloudcorprecords/musicport:0.1.0

工具

12

收录的工具列表 · 更新于 1 周前

参数类型必填说明
typestring否要搜索的项目类型（可选；省略时默认为 'track'）。
limitnumber否要返回的搜索结果数量上限（可选）。
querystring是用于查询 Spotify 目录的搜索文本，通过 q 参数发送。

详细介绍

musicport

将 Spotify 搜索、播放和播放列表作为 MCP 工具，接入 Spotify Web API。musicport 是对社区 Spotify MCP 服务核心功能的全新实现，采用新名称：全新代码，不复制品牌。

仅使用 TOKEN 环境变量。 不会复现托管版／社区版 OAuth 流程（SPOTIFY_CLIENT_ID / SPOTIFY_CLIENT_SECRET + 浏览器授权 + 刷新）。工具会直接将 SPOTIFY_ACCESS_TOKEN 用作 Authorization: Bearer。

工具（核心子集，共 12 个）

search、get_current_user_profile、get_playback_state、play、 pause、next_track、previous_track、list_playlists、 get_playlist、create_playlist、add_tracks_to_playlist、 list_saved_tracks。

本子集不包含：OAuth 授权／刷新流程；搜索之外的曲目／专辑／艺人详情读取；音频特征／分析；推荐；节目／单集／有声书；关注／取消关注艺人和用户；播放列表封面图片；播放列表项目的移除／深度排序；音乐库专辑／节目；设备列表和播放转移；队列管理；最近播放；热门项目。

设置

通过自己的方式获取 Spotify 访问令牌并设置：

export SPOTIFY_ACCESS_TOKEN=BQ...

也可通过 SPOTIFY_API_BASE_URL 覆盖 API 基础地址（默认值为 https://api.spotify.com/v1）。如果未设置令牌，每次工具调用都会失败，并指出缺少的变量： SPOTIFY_ACCESS_TOKEN environment variable is required。

CLI

npx @reneturcios/musicport search '{"query":"hello"}'
npx @reneturcios/musicport mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "musicport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/musicport", "mcp"],
      "env": { "SPOTIFY_ACCESS_TOKEN": "BQ..." }
    }
  }
}

Docker

docker run -i -e SPOTIFY_ACCESS_TOKEN ghcr.io/cloudcorprecords/musicport

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。