@eldment/meting-mcp 1.6.2 → 1.6.4

package/README.md

@@ -1,6 +1,6 @@
 # Meting-MCP
 
-`Meting-MCP` 是基于 **[metowolf/Meting](https://github.com/metowolf/Meting)** 构建的 MCP Server，支持 `netease`、`tencent`、`kugou`、`baidu`、`kuwo` 等音乐平台，提供搜索、歌曲、专辑、歌手、歌单、播放链接、歌词、封面等能力
+`Meting-MCP` 是基于 **[metowolf/Meting](https://github.com/metowolf/Meting)** 构建的 MCP Server，支持 [网易云音乐](https://music.163.com/)（`netease`）、[腾讯音乐](https://y.qq.com/)（`tencent`）、[酷狗音乐](https://www.kugou.com/)（`kugou`）、[千千音乐](https://music.taihe.com/)（`baidu`）、[酷我音乐](https://www.kuwo.cn/)（`kuwo`） 等音乐平台，提供搜索、歌曲、专辑、歌手、歌单、播放链接、歌词、封面等能力
 
 ## 提供的 MCP 工具
 
@@ -23,11 +23,11 @@ Claude 示例配置：
   "mcpServers": {
     "meting": {
       "command": "npx",
-      "args": [
-        "-y",
-        "@eldment/meting-mcp@latest"
-      ],
-      "env": {},
+      "args": ["-y", "@eldment/meting-mcp@latest"],
+      "env": {
+        "METING_NETEASE_COOKIE": "...",
+        "METING_TENCENT_COOKIE": "..."
+      },
       "timeout": 60000
     }
   }
@@ -44,11 +44,33 @@ args = [
     "-y",
     "@eldment/meting-mcp@latest",
 ]
-env = {}
+env = {
+    METING_NETEASE_COOKIE = "...",
+    METING_TENCENT_COOKIE = "...",
+}
 tool_timeout_sec = 60
 disabled = false
 ```
 
+## Cookie 配置
+
+MCP 运行时会优先从环境变量读取 cookie，再回退到工具输入参数传入的 cookie，优先级如下：
+
+1. `METING_<PLATFORM>_COOKIE`
+2. `METING_COOKIE`
+3. MCP 工具调用时传入的 `cookie`
+
+当前支持的环境变量：
+
+- `METING_NETEASE_COOKIE`
+- `METING_TENCENT_COOKIE`
+- `METING_KUGOU_COOKIE`
+- `METING_BAIDU_COOKIE`
+- `METING_KUWO_COOKIE`
+- `METING_COOKIE`（兜底变量）
+
+如果只需要给某一个平台带 cookie，优先使用对应的平台变量；如果想统一兜底，可以只设置 `METING_COOKIE`
+
 ---
 
 关键词: MCP Server | Model Context Protocol | Music API | Node.js MCP | AI Tool Integration | NetEase Cloud Music | Tencent QQ Music | KuGou Music | Baidu Music | Kuwo Music | Lyrics API | Playlist API

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eldment/meting-mcp",
-  "version": "1.6.2",
+  "version": "1.6.4",
   "description": "MCP server wrapper for the Meting multi-platform music API core.",
   "type": "module",
   "main": "./src/mcp-server.js",
@@ -17,6 +17,8 @@
   "scripts": {
     "start": "node src/index.js",
     "lint": "node --check src/index.js && node --check src/mcp-server.js && node --check src/meting.js && node --check src/providers/index.js && node --check test/test.js && node --check test/example.js",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "test": "node test/test.js",
     "example": "node test/example.js",
     "build": "npm pack --dry-run",
@@ -59,5 +61,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
     "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "prettier": "^3.6.2"
   }
 }

package/src/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CreateMcpServer, serviceMetadata } from "./mcp-server.js";
@@ -12,7 +12,7 @@ function GetHelpText() {
     "Usage:",
     "  meting-mcp            Start the MCP stdio server",
     "  meting-mcp --help     Show help",
-    "  meting-mcp --version  Show version"
+    "  meting-mcp --version  Show version",
   ].join("\n");
 }
 
@@ -47,7 +47,9 @@ async function Main() {
   await StartServer();
 }
 
-Main().catch(error => {
-  process.stderr.write(`meting-mcp failed to start: ${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+Main().catch((error) => {
+  process.stderr.write(
+    `meting-mcp failed to start: ${error instanceof Error ? (error.stack ?? error.message) : String(error)}\n`
+  );
   process.exit(1);
 });

package/src/mcp-server.js

@@ -1,10 +1,20 @@
+import { createRequire } from "module";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import * as z from "zod/v4";
 import Meting from "./meting.js";
 
+const require = createRequire(import.meta.url);
+const { name: packageName, version } = require("../package.json");
+
+const packageUrl = `https://www.npmjs.com/package/${packageName}`;
+
 export const serviceMetadata = Object.freeze({
   name: "meting-mcp",
-  version: "1.6.1"
+  version,
+  title: "Meting MCP",
+  description:
+    "Search music and fetch song, album, artist, playlist, lyrics, cover, and play URL data across NetEase, Tencent, KuGou, Baidu, and Kuwo.",
+  websiteUrl: packageUrl,
 });
 
 const platformCatalog = Object.freeze([
@@ -12,15 +22,36 @@ const platformCatalog = Object.freeze([
   { name: "Tencent Music", code: "tencent" },
   { name: "KuGou Music", code: "kugou" },
   { name: "Baidu Music", code: "baidu" },
-  { name: "Kuwo Music", code: "kuwo" }
+  { name: "Kuwo Music", code: "kuwo" },
 ]);
 
 const platformSchema = z.enum(Meting.getSupportedPlatforms());
 
-function CreateClient(platform, cookie) {
+const cookieEnvNames = Object.freeze({
+  netease: "METING_NETEASE_COOKIE",
+  tencent: "METING_TENCENT_COOKIE",
+  kugou: "METING_KUGOU_COOKIE",
+  baidu: "METING_BAIDU_COOKIE",
+  kuwo: "METING_KUWO_COOKIE",
+});
+
+function ReadEnvValue(name) {
+  const value = process.env[name];
+  return typeof value === "string" && value.trim() !== "" ? value : undefined;
+}
+
+export function ResolveCookie(platform, inputCookie) {
+  const platformCookie = ReadEnvValue(cookieEnvNames[platform]);
+  const fallbackCookie = ReadEnvValue("METING_COOKIE");
+  return platformCookie ?? fallbackCookie ?? inputCookie;
+}
+
+function CreateClient(platform, inputCookie) {
   const meting = new Meting(platform);
   meting.format(true);
 
+  const cookie = ResolveCookie(platform, inputCookie);
+
   if (cookie) {
     meting.cookie(cookie);
   }
@@ -46,9 +77,9 @@ function CreateTextResult(result, isError = false) {
     content: [
       {
         type: "text",
-        text: JSON.stringify(result, null, 2)
-      }
-    ]
+        text: JSON.stringify(result, null, 2),
+      },
+    ],
   };
 }
 
@@ -57,7 +88,7 @@ function CreateOperationResult(operation, platform, data) {
     ok: true,
     operation,
     platform,
-    data
+    data,
   };
 }
 
@@ -66,27 +97,32 @@ function CreateOperationError(operation, platform, error) {
     ok: false,
     operation,
     platform,
-    message: error instanceof Error ? error.message : String(error)
+    message: error instanceof Error ? error.message : String(error),
   };
 }
 
 function WithCommonInput(extraSchema) {
   return {
     platform: platformSchema.describe("Music platform code."),
-    cookie: z.string().optional().describe("Optional platform cookie."),
-    ...extraSchema
+    cookie: z
+      .string()
+      .optional()
+      .describe(
+        "Optional platform cookie. Lower priority than METING_<PLATFORM>_COOKIE and METING_COOKIE."
+      ),
+    ...extraSchema,
   };
 }
 
-function RegisterTool(server, toolName, description, inputSchema, handler) {
+function RegisterTool(server, toolName, title, description, inputSchema, handler) {
   server.registerTool(
     toolName,
     {
-      title: toolName,
+      title,
       description,
-      inputSchema
+      inputSchema,
     },
-    async input => {
+    async (input) => {
       try {
         const data = await handler(input);
         return CreateTextResult(CreateOperationResult(toolName, input.platform, data));
@@ -103,13 +139,13 @@ export function CreateMcpServer() {
   server.registerTool(
     "platforms",
     {
-      title: "platforms",
-      description: "List supported music platforms."
+      title: "List Supported Platforms",
+      description: "List supported music platforms.",
     },
     async () => {
       return CreateTextResult({
         ok: true,
-        data: platformCatalog
+        data: platformCatalog,
       });
     }
   );
@@ -117,14 +153,20 @@ export function CreateMcpServer() {
   RegisterTool(
     server,
     "search",
+    "Search Music",
     "Search songs, albums or artists on a specific platform.",
     WithCommonInput({
       keyword: z.string().min(1).describe("Search keyword."),
-      type: z.number().int().positive().optional().describe("Optional platform-specific search type."),
+      type: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Optional platform-specific search type."),
       page: z.number().int().positive().optional().describe("Optional page number."),
-      limit: z.number().int().positive().max(100).optional().describe("Optional page size.")
+      limit: z.number().int().positive().max(100).optional().describe("Optional page size."),
     }),
-    async input => {
+    async (input) => {
       const meting = CreateClient(input.platform, input.cookie);
       const options = {};
 
@@ -147,11 +189,12 @@ export function CreateMcpServer() {
   RegisterTool(
     server,
     "song",
+    "Get Song Details",
     "Get song detail by id.",
     WithCommonInput({
-      id: z.string().min(1).describe("Song id.")
+      id: z.string().min(1).describe("Song id."),
     }),
-    async input => {
+    async (input) => {
       const meting = CreateClient(input.platform, input.cookie);
       return ParseResult(await meting.song(input.id));
     }
@@ -160,11 +203,12 @@ export function CreateMcpServer() {
   RegisterTool(
     server,
     "album",
+    "Get Album Details",
     "Get album detail by id.",
     WithCommonInput({
-      id: z.string().min(1).describe("Album id.")
+      id: z.string().min(1).describe("Album id."),
     }),
-    async input => {
+    async (input) => {
       const meting = CreateClient(input.platform, input.cookie);
       return ParseResult(await meting.album(input.id));
     }
@@ -173,12 +217,13 @@ export function CreateMcpServer() {
   RegisterTool(
     server,
     "artist",
+    "Get Artist Works",
     "Get artist songs by id.",
     WithCommonInput({
       id: z.string().min(1).describe("Artist id."),
-      limit: z.number().int().positive().max(200).optional().describe("Optional result size.")
+      limit: z.number().int().positive().max(200).optional().describe("Optional result size."),
     }),
-    async input => {
+    async (input) => {
       const meting = CreateClient(input.platform, input.cookie);
       return ParseResult(await meting.artist(input.id, input.limit));
     }
@@ -187,11 +232,12 @@ export function CreateMcpServer() {
   RegisterTool(
     server,
     "playlist",
+    "Get Playlist Details",
     "Get playlist detail by id.",
     WithCommonInput({
-      id: z.string().min(1).describe("Playlist id.")
+      id: z.string().min(1).describe("Playlist id."),
     }),
-    async input => {
+    async (input) => {
       const meting = CreateClient(input.platform, input.cookie);
       return ParseResult(await meting.playlist(input.id));
     }
@@ -200,12 +246,13 @@ export function CreateMcpServer() {
   RegisterTool(
     server,
     "url",
+    "Get Play URL",
     "Get playable song url by id.",
     WithCommonInput({
       id: z.string().min(1).describe("Song id."),
-      br: z.number().int().positive().optional().describe("Optional bitrate.")
+      br: z.number().int().positive().optional().describe("Optional bitrate."),
     }),
-    async input => {
+    async (input) => {
       const meting = CreateClient(input.platform, input.cookie);
       return ParseResult(await meting.url(input.id, input.br));
     }
@@ -214,11 +261,12 @@ export function CreateMcpServer() {
   RegisterTool(
     server,
     "lyric",
+    "Get Lyrics",
     "Get song lyric by id.",
     WithCommonInput({
-      id: z.string().min(1).describe("Song id.")
+      id: z.string().min(1).describe("Song id."),
     }),
-    async input => {
+    async (input) => {
       const meting = CreateClient(input.platform, input.cookie);
       return ParseResult(await meting.lyric(input.id));
     }
@@ -227,12 +275,13 @@ export function CreateMcpServer() {
   RegisterTool(
     server,
     "pic",
+    "Get Cover Image",
     "Get cover or picture url by id.",
     WithCommonInput({
       id: z.string().min(1).describe("Picture id."),
-      size: z.number().int().positive().optional().describe("Optional picture size.")
+      size: z.number().int().positive().optional().describe("Optional picture size."),
     }),
-    async input => {
+    async (input) => {
       const meting = CreateClient(input.platform, input.cookie);
       return ParseResult(await meting.pic(input.id, input.size));
     }

package/src/meting.js

@@ -7,12 +7,12 @@
  * Released under the MIT license
  */
 
-import { URLSearchParams } from 'url';
-import ProviderFactory from './providers/index.js';
+import { URLSearchParams } from "url";
+import ProviderFactory from "./providers/index.js";
 
 class Meting {
-  constructor(server = 'netease') {
-    this.VERSION = '__VERSION__'; // 在构建时由 rollup 替换为实际版本号
+  constructor(server = "netease") {
+    this.VERSION = "__VERSION__"; // 在构建时由 rollup 替换为实际版本号
     this.raw = null;
     this.info = null;
     this.error = null;
@@ -30,7 +30,7 @@ class Meting {
   // 设置音乐平台
   site(server) {
     if (!ProviderFactory.isSupported(server)) {
-      server = 'netease'; // 默认使用网易云音乐
+      server = "netease"; // 默认使用网易云音乐
     }
 
     this.server = server;
@@ -42,7 +42,7 @@ class Meting {
 
   // 设置 Cookie
   cookie(cookie) {
-    this.header['Cookie'] = cookie;
+    this.header["Cookie"] = cookie;
     return this;
   }
 
@@ -61,15 +61,15 @@ class Meting {
   // HTTP 请求方法 - 使用 fetch API
   async _curl(url, payload = null, headerOnly = false) {
     const requestOptions = {
-      method: payload ? 'POST' : 'GET',
-      headers: { ...this.header }
+      method: payload ? "POST" : "GET",
+      headers: { ...this.header },
     };
 
     // 处理请求体
     if (payload) {
-      if (typeof payload === 'object' && !Buffer.isBuffer(payload) && typeof payload !== 'string') {
+      if (typeof payload === "object" && !Buffer.isBuffer(payload) && typeof payload !== "string") {
         payload = new URLSearchParams(payload).toString();
-        requestOptions.headers['Content-Type'] = 'application/x-www-form-urlencoded';
+        requestOptions.headers["Content-Type"] = "application/x-www-form-urlencoded";
       }
       requestOptions.body = payload;
     }
@@ -83,38 +83,38 @@ class Meting {
     const makeRequest = async () => {
       try {
         const response = await fetch(url, requestOptions);
-        
+
         clearTimeout(timeoutId);
-        
+
         // 存储响应信息
         this.info = {
           statusCode: response.status,
-          headers: Object.fromEntries(response.headers.entries())
+          headers: Object.fromEntries(response.headers.entries()),
         };
 
         // 获取响应数据
         const data = await response.text();
         this.raw = data;
         this.error = null;
-        this.status = '';
-        
+        this.status = "";
+
         return this;
       } catch (err) {
         clearTimeout(timeoutId);
-        
+
         // 处理错误
-        if (err.name === 'AbortError') {
-          this.error = 'TIMEOUT';
-          this.status = 'Request timeout';
+        if (err.name === "AbortError") {
+          this.error = "TIMEOUT";
+          this.status = "Request timeout";
         } else {
           this.error = err.code || err.name;
           this.status = err.message;
         }
-        
+
         // 重试机制
         if (retries > 0) {
           retries--;
-          await new Promise(resolve => setTimeout(resolve, 1000));
+          await new Promise((resolve) => setTimeout(resolve, 1000));
           return makeRequest();
         } else {
           return this;
@@ -125,7 +125,6 @@ class Meting {
     return await makeRequest();
   }
 
-
   // ========== 公共 API 方法 ==========
 
   // 搜索功能