Skip to main content
Glama
CloudmusicMCP

CloudmusicMCP

CloudmusicMCP

A local stdio MCP server for searching NetEase Cloud Music and safely managing playlists. It starts the linked api-enhanced backend automatically and includes three optional, generic Codex skills for curation, feedback synchronization and audits.

This repository contains no account cookie, listening history, liked-track export, recommendation state or personal taste profile.

Playlist writes are cache-safe: the installer patches the linked upstream backend so a NetEase business error returned as HTTP 200 cannot be replayed from its two-minute cache.

Quick start

Clone with the backend submodule:

git clone --recurse-submodules https://github.com/LoranaAurelia/CloudmusicMCP.git
cd CloudmusicMCP
.\install.ps1
.\login.bat

If you downloaded GitHub's source ZIP, extract it and run install.ps1; the installer fetches the official backend repository when submodule content is absent.

Related MCP server: netease-mcp

Repository layout

api-enhanced/    Git submodule pointing to the upstream backend
src/             MCP server and backend lifecycle
scripts/         QR login and manual backend control
skills/          Generic Codex skills
config/          Empty recommender preference template
docs/            User and Agent documentation

The wrapper is MIT licensed. The linked backend keeps its own upstream license and history.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for controlling local music playback via NetEase Cloud Music, enabling search, play, pause, skip, and lyrics display through a local web player.
      13
      86
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that enables AI assistants to search and retrieve music data (songs, lyrics, playlists, albums, artists) from Netease Cloud Music.
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Multi-source music search and playback MCP server supporting QQ Music, NetEase Cloud, and local files with playlist management.
      3
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      非官方MCP服务,允许通过统一的工具接口操作网易云音乐,包括搜索歌曲、创建与管理歌单、查看听歌记录、收藏歌曲及获取每日推荐。
      1
      MIT