ym-mcp-wangyi 0.1.0

package/dist/lib/paths.js

@@ -0,0 +1,101 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+export const APP_NAME = "网易云音乐";
+export const SEARCH_URL = "https://music.163.com/api/cloudsearch/pc";
+export const USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) NeteaseMusic/3.1.12";
+const STORAGE_MARKERS = ["mmkv.default", "CEFCache", "file_storage"];
+function homeDir(env) {
+    return env.HOME || homedir();
+}
+function looksLikeStorage(dir) {
+    return STORAGE_MARKERS.some((name) => existsSync(join(dir, name)));
+}
+/** Candidate user-data / storage roots for NetEase desktop client. */
+export function storageCandidates(platform = process.platform, env = process.env) {
+    const home = homeDir(env);
+    if (platform === "darwin") {
+        return [
+            join(home, "Library", "Containers", "com.netease.163music", "Data", "Documents", "storage"),
+            join(home, "Library", "Application Support", "com.netease.163music", "Documents", "storage"),
+            join(home, "Library", "Application Support", "com.netease.163music", "storage"),
+            join(home, "Library", "Application Support", "NeteaseMusic", "storage"),
+        ];
+    }
+    if (platform === "win32") {
+        const roaming = env.APPDATA || join(home, "AppData", "Roaming");
+        const local = env.LOCALAPPDATA || join(home, "AppData", "Local");
+        const roots = [roaming, local];
+        const brands = ["NetEase", "Netease", "NeteaseCloudMusic", "NeteaseMusic", "CloudMusic"];
+        const tails = [
+            ["CloudMusic", "storage"],
+            ["CloudMusic", "Documents", "storage"],
+            ["CloudMusic", "data", "storage"],
+            ["storage"],
+            ["Documents", "storage"],
+        ];
+        return roots.flatMap((root) => brands.flatMap((brand) => tails.map((tail) => join(root, brand, ...tail))));
+    }
+    return [
+        join(home, ".config", "NetEase", "CloudMusic", "storage"),
+        join(home, ".config", "NeteaseMusic", "storage"),
+    ];
+}
+export function resolveStorageDir(platform = process.platform, env = process.env) {
+    const candidates = storageCandidates(platform, env);
+    return candidates.find(looksLikeStorage) || candidates[0];
+}
+let cachedStorageDir = "";
+export function storageDir() {
+    if (!cachedStorageDir)
+        cachedStorageDir = resolveStorageDir();
+    return cachedStorageDir;
+}
+/** Test helper: clear cached path resolution. */
+export function resetStorageDirCache() {
+    cachedStorageDir = "";
+}
+export function mmkvPath() {
+    return join(storageDir(), "mmkv.default");
+}
+export function cookieDbPath() {
+    return join(storageDir(), "CEFCache", "Cookies");
+}
+export function localStatePath() {
+    return join(storageDir(), "CEFCache", "Local State");
+}
+export function playingListPath() {
+    return join(storageDir(), "file_storage", "webdata", "file", "playingList");
+}
+export function hasUserData() {
+    return looksLikeStorage(storageDir());
+}
+export function installCandidates(platform = process.platform, env = process.env) {
+    const home = homeDir(env);
+    if (platform === "darwin") {
+        return [
+            join("/Applications", "NeteaseMusic.app"),
+            join(home, "Applications", "NeteaseMusic.app"),
+            join("/Applications", `${APP_NAME}.app`),
+            join(home, "Applications", `${APP_NAME}.app`),
+        ];
+    }
+    if (platform === "win32") {
+        const local = env.LOCALAPPDATA || join(home, "AppData", "Local");
+        const programFiles = env.ProgramW6432 || env.ProgramFiles || "C:\\Program Files";
+        const programFilesX86 = env["ProgramFiles(x86)"] || "C:\\Program Files (x86)";
+        const exeNames = ["cloudmusic.exe", "CloudMusic.exe", "NeteaseCloudMusic.exe"];
+        const dirNames = ["CloudMusic", "Netease", "NetEase", "NeteaseCloudMusic"];
+        const roots = [
+            join(local, "Programs"),
+            programFiles,
+            programFilesX86,
+            join(programFiles, "Netease"),
+            join(programFilesX86, "Netease"),
+            join(local, "NetEase"),
+            join(local, "Netease"),
+        ];
+        return roots.flatMap((root) => dirNames.flatMap((dir) => exeNames.map((exe) => join(root, dir, exe))));
+    }
+    return [];
+}

package/dist/lib/play.js

@@ -0,0 +1,45 @@
+import { ToolError } from "./errors.js";
+import { isInstalled, openOrpheusUrl } from "./process.js";
+import { writeLastPlay } from "./last-play.js";
+import { cdpPlayerState, isCdpReady } from "./cdp.js";
+/** Desktop orpheus command used by the official Windows/macOS clients. */
+export function playUrl(trackId, kind = "song") {
+    const command = { type: kind, id: String(trackId), cmd: "play" };
+    const encoded = Buffer.from(JSON.stringify(command), "utf8").toString("base64");
+    return `orpheus://${encoded}`;
+}
+async function waitForCdpSong(songId, timeoutMs = 8000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        try {
+            const state = await cdpPlayerState();
+            if (state.songId === songId)
+                return true;
+        }
+        catch {
+            // CDP may briefly disconnect while the client switches tracks.
+        }
+        await new Promise((r) => setTimeout(r, 300));
+    }
+    return false;
+}
+export async function playTrackById(trackId, _title = "") {
+    const id = String(trackId || "").trim();
+    if (!/^\d+$/.test(id)) {
+        throw new ToolError("INVALID_ARGS", "track id 必须是数字", "先 wangyi_search 拿 id，再 wangyi_play");
+    }
+    if (!isInstalled()) {
+        throw new ToolError("NOT_INSTALLED", "未找到网易云音乐客户端", "先安装并登录网易云音乐，再重试");
+    }
+    const url = playUrl(id);
+    openOrpheusUrl(url);
+    writeLastPlay(id);
+    if (await isCdpReady()) {
+        const ok = await waitForCdpSong(id);
+        if (!ok) {
+            throw new ToolError("PLAY_NOT_CONFIRMED", `已发送播放指令，但客户端未切到 ${id}`, "确认网易云在前台且已登录；可再执行一次 launch 后重试");
+        }
+        return `${url}#via=orpheus+cdp-confirmed`;
+    }
+    return `${url}#via=orpheus`;
+}

package/dist/lib/process.js

@@ -0,0 +1,51 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { hasUserData, installCandidates } from "./paths.js";
+export function isInstalled() {
+    if (hasUserData())
+        return true;
+    return installCandidates().some((p) => existsSync(p));
+}
+export function isRunning() {
+    if (process.platform === "darwin") {
+        const result = spawnSync("pgrep", ["-x", "NeteaseMusic"], { encoding: "utf8" });
+        return result.status === 0 && Boolean(result.stdout.trim());
+    }
+    if (process.platform === "win32") {
+        const result = spawnSync("tasklist", ["/FI", "IMAGENAME eq cloudmusic.exe", "/FO", "CSV", "/NH"], { encoding: "utf8", windowsHide: true });
+        const out = (result.stdout || "").toLowerCase();
+        return out.includes("cloudmusic.exe");
+    }
+    return false;
+}
+export function orpheusProtocolOk() {
+    return isInstalled();
+}
+export function protocolOpener(url, platform = process.platform) {
+    if (platform === "win32") {
+        const safe = url.replace(/"/g, "");
+        return {
+            cmd: "cmd.exe",
+            args: ["/d", "/s", "/c", `start "" "${safe}"`],
+            windowsVerbatimArguments: true,
+        };
+    }
+    if (platform === "darwin") {
+        // Bind to the official app so Launch Services does not drop custom orpheus commands.
+        return { cmd: "open", args: ["-a", "NeteaseMusic", url] };
+    }
+    return { cmd: "xdg-open", args: [url] };
+}
+export function openOrpheusUrl(url) {
+    const { cmd, args, windowsVerbatimArguments } = protocolOpener(url);
+    const result = spawnSync(cmd, args, {
+        timeout: 10000,
+        stdio: "ignore",
+        windowsVerbatimArguments,
+    });
+    if (result.error)
+        throw result.error;
+    if (result.status !== 0 && result.status != null) {
+        throw new Error(`${cmd} exited ${result.status}`);
+    }
+}

package/dist/lib/queue.js

@@ -0,0 +1,131 @@
+import { existsSync, readFileSync } from "node:fs";
+import { playingListPath } from "./paths.js";
+import { ToolError } from "./errors.js";
+import { playTrackById } from "./play.js";
+import { readLastPlay } from "./last-play.js";
+import { cdpPlayerState, cdpSkip, isCdpReady } from "./cdp.js";
+function formatDuration(ms) {
+    const total = Math.round(Number(ms || 0) / 1000);
+    if (!total)
+        return "";
+    const m = Math.floor(total / 60);
+    const s = String(total % 60).padStart(2, "0");
+    return `${m}:${s}`;
+}
+function artistNames(artists) {
+    if (!Array.isArray(artists))
+        return "";
+    return artists
+        .map((a) => (a && typeof a === "object" && "name" in a ? String(a.name || "") : ""))
+        .filter(Boolean)
+        .join(", ");
+}
+function mapTrack(item, index, currentId, source) {
+    const track = item.track || {};
+    const id = String(track.id || item.id || "");
+    return {
+        index: index + 1,
+        current: id === currentId,
+        id,
+        title: track.name || "",
+        artist: artistNames(track.artists),
+        album: (track.album && track.album.name) || "",
+        duration: formatDuration(track.duration),
+        source,
+    };
+}
+function readCachedQueue() {
+    const file = playingListPath();
+    if (!existsSync(file)) {
+        throw new ToolError("QUEUE_MISSING", "读不到网易云音乐的播放队列缓存", `客户端播过歌后才会写入 ${file}`);
+    }
+    let data;
+    try {
+        data = JSON.parse(readFileSync(file, "utf8"));
+    }
+    catch {
+        throw new ToolError("QUEUE_MISSING", "播放队列缓存无法解析", file);
+    }
+    const list = Array.isArray(data.list) ? [...data.list] : [];
+    if (!list.length) {
+        throw new ToolError("QUEUE_EMPTY", "播放队列缓存是空的", "先在客户端播一首歌");
+    }
+    list.sort((a, b) => Number(a.displayOrder ?? 0) - Number(b.displayOrder ?? 0));
+    const tracksPreview = list.map((item) => String(item.track?.id || item.id || ""));
+    const last = readLastPlay();
+    let index = 0;
+    if (last?.id) {
+        const found = tracksPreview.findIndex((id) => id === last.id);
+        if (found >= 0)
+            index = found;
+    }
+    const currentId = tracksPreview[index] || "";
+    const tracks = list.map((item, i) => mapTrack(item, i, currentId, "playingList"));
+    return {
+        source: "playingList",
+        hasMore: false,
+        index,
+        tracks,
+        current: tracks[index],
+    };
+}
+export async function readPlayerQueue() {
+    if (await isCdpReady()) {
+        try {
+            const state = await cdpPlayerState();
+            if (state.queue.length) {
+                const currentId = state.songId || state.queue[0]?.id || "";
+                const index = Math.max(0, state.queue.findIndex((t) => t.id === currentId));
+                const tracks = state.queue.map((t, i) => ({
+                    index: i + 1,
+                    current: t.id === currentId,
+                    id: t.id,
+                    title: t.title,
+                    artist: "",
+                    album: "",
+                    duration: "",
+                    source: "cdp",
+                }));
+                return {
+                    source: "cdp",
+                    hasMore: false,
+                    index: index < 0 ? 0 : index,
+                    tracks,
+                    current: tracks[index < 0 ? 0 : index],
+                };
+            }
+        }
+        catch {
+            // fall through to file cache
+        }
+    }
+    return readCachedQueue();
+}
+export async function skipPlayerQueue(delta) {
+    if (await isCdpReady()) {
+        try {
+            await cdpSkip(delta > 0 ? 1 : -1);
+            await new Promise((r) => setTimeout(r, 400));
+            const queue = await readPlayerQueue();
+            return {
+                ...queue.current,
+                current: true,
+                status: delta > 0 ? "next" : "prev",
+            };
+        }
+        catch {
+            // fall through to id-based skip
+        }
+    }
+    const queue = await readPlayerQueue();
+    const nextIndex = queue.index + delta;
+    if (nextIndex < 0) {
+        throw new ToolError("EMPTY_RESULT", "已经是当前列表第一首");
+    }
+    if (nextIndex >= queue.tracks.length) {
+        throw new ToolError("EMPTY_RESULT", "已经是当前列表最后一首");
+    }
+    const track = queue.tracks[nextIndex];
+    await playTrackById(track.id, track.title);
+    return { ...track, current: true, index: nextIndex + 1, status: delta > 0 ? "next" : "prev" };
+}

package/dist/lib/status.js

@@ -0,0 +1,58 @@
+import { existsSync } from "node:fs";
+import { cookieDbPath, mmkvPath, playingListPath, storageDir } from "./paths.js";
+import { loadCookies } from "./cookies.js";
+import { isInstalled, isRunning, orpheusProtocolOk } from "./process.js";
+import { readPlayerQueue } from "./queue.js";
+import { DEFAULT_CDP_PORT, isCdpReady } from "./cdp.js";
+export async function getStatus() {
+    const hints = [];
+    if (process.platform === "linux") {
+        hints.push("网易云音乐官方桌面端主要支持 Windows / macOS；Linux 上协议播放可能不可用");
+    }
+    const installed = isInstalled();
+    if (!installed) {
+        hints.push("未检测到网易云音乐用户数据或安装目录，请先安装并打开一次客户端");
+    }
+    const running = isRunning();
+    const cookies = loadCookies();
+    const loggedIn = cookies.loggedIn;
+    if (!loggedIn) {
+        hints.push(cookies.cookieEncrypted
+            ? `Cookie 仍是密文，未能解密 MUSIC_U。CEF：${cookieDbPath()}；MMKV：${mmkvPath()}`
+            : `未读到登录态。请先用网易云音乐登录。存储：${storageDir()}`);
+    }
+    let queueOk = false;
+    try {
+        if (existsSync(playingListPath()) || (await isCdpReady())) {
+            const queue = await readPlayerQueue();
+            queueOk = queue.tracks.length > 0;
+        }
+    }
+    catch {
+        queueOk = false;
+    }
+    if (!queueOk) {
+        hints.push(`播放队列为空或无法解析：${playingListPath()}，先在客户端播一首歌`);
+    }
+    const protocolOk = orpheusProtocolOk();
+    const cdpOk = await isCdpReady(DEFAULT_CDP_PORT);
+    if (!cdpOk) {
+        hints.push(`要真正控制桌面端播放/切歌，请先执行: node dist/index.js launch（会以 CDP 端口 ${DEFAULT_CDP_PORT} 重启网易云）`);
+    }
+    const ready = installed && loggedIn;
+    return {
+        ready,
+        installed,
+        running,
+        logged_in: loggedIn,
+        cookie_encrypted: cookies.cookieEncrypted,
+        queue_ok: queueOk,
+        protocol_ok: protocolOk,
+        cdp_ok: cdpOk,
+        cdp_port: DEFAULT_CDP_PORT,
+        storage_dir: storageDir(),
+        cookie_source: cookies.source,
+        platform: process.platform,
+        hints,
+    };
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "ym-mcp-wangyi",
+  "version": "0.1.0",
+  "description": "网易云音乐 MCP：搜索、播放、队列切歌（macOS / Windows）",
+  "type": "module",
+  "bin": {
+    "ym-mcp-wangyi": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "packageManager": "pnpm@10.0.0",
+  "scripts": {
+    "clean": "node --input-type=module -e \"import { rmSync } from 'node:fs'; rmSync('dist', { recursive: true, force: true })\"",
+    "build": "pnpm clean && tsc",
+    "start": "node dist/index.js",
+    "cli": "node dist/index.js",
+    "test": "pnpm build && node --experimental-strip-types --test --test-concurrency=1 test/features.test.ts",
+    "prepublishOnly": "pnpm test"
+  },
+  "keywords": [
+    "mcp",
+    "netease",
+    "wangyi",
+    "网易云音乐"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "typescript": "^5.9.2"
+  }
+}