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.

• User instructions: docs/USER_GUIDE.md
• Agent deployment instructions: docs/AGENT_DEPLOYMENT.md
• MCP tools: docs/MCP_TOOL_REFERENCE.md
• Security and privacy: SECURITY.md

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.