@eldment/meting-mcp 1.6.1 → 1.6.3

package/ACKNOWLEDGEMENTS.md

@@ -0,0 +1,9 @@
+# 致谢
+
+`Meting-MCP` 基于原项目 **[metowolf/Meting](https://github.com/metowolf/Meting)** 构建
+
+- 原项目：`metowolf/Meting`
+- 原作者：`metowolf` / `METO`
+- 原始许可证：[MIT](./LICENSE)
+
+本仓库在保留原项目信息与许可证声明的前提下，将 Meting 核心封装为 MCP Server

package/README.md

@@ -1,77 +1,76 @@
-# @eldment/meting-mcp
+# Meting-MCP
 
-`@eldment/meting-mcp` 基于原版 **Meting Node.js** 核心实现，只保留适合 MCP Server 发布与运行的形态。底层支持这些平台：
+`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`） 等音乐平台，提供搜索、歌曲、专辑、歌手、歌单、播放链接、歌词、封面等能力
 
-- `netease`
-- `tencent`
-- `kugou`
-- `baidu`
-- `kuwo`
+## 提供的 MCP 工具
 
-## 功能概览
-
-- 基于原版 Meting 的统一音乐接口
-- 通过 stdio 暴露为 MCP Server
-- 支持搜索、歌曲、专辑、歌手、歌单、播放链接、歌词、封面等操作
-- 所有 MCP 工具默认返回格式化后的 JSON 文本
-
-## 安装
-
-```bash
-npm install
-```
-
-发布后可直接运行：
-
-```bash
-npx @eldment/meting-mcp
-```
+- `platforms`: 列出当前支持的音乐平台及其平台代号
+- `search`: 按关键字在指定平台搜索歌曲、专辑、歌手或其他资源
+- `song`: 按歌曲 ID 获取歌曲详情
+- `album`: 按专辑 ID 获取专辑详情
+- `artist`: 按歌手 ID 获取歌手信息或作品列表
+- `playlist`: 按歌单 ID 获取歌单内容
+- `url`: 按歌曲 ID 获取可播放链接
+- `lyric`: 按歌曲 ID 获取歌词内容
+- `pic`: 按图片或资源 ID 获取封面图链接
 
 ## MCP 接入
 
-示例配置：
+Claude 示例配置：
 
 ```json
 {
   "mcpServers": {
     "meting": {
       "command": "npx",
-      "args": ["-y", "@eldment/meting-mcp"]
+      "args": ["-y", "@eldment/meting-mcp@latest"],
+      "env": {
+        "METING_NETEASE_COOKIE": "...",
+        "METING_TENCENT_COOKIE": "..."
+      },
+      "timeout": 60000
     }
   }
 }
 ```
 
-提供的 MCP 工具：
+Codex 示例配置：
+
+```toml
+[mcp_servers.meting]
+type = "stdio"
+command = "npx"
+args = [
+    "-y",
+    "@eldment/meting-mcp@latest",
+]
+env = {
+    METING_NETEASE_COOKIE = "...",
+    METING_TENCENT_COOKIE = "...",
+}
+tool_timeout_sec = 60
+disabled = false
+```
 
-- `platforms`
-- `search`
-- `song`
-- `album`
-- `artist`
-- `playlist`
-- `url`
-- `lyric`
-- `pic`
+## Cookie 配置
 
-## 工具参数
+MCP 运行时会优先从环境变量读取 cookie，再回退到工具输入参数传入的 cookie，优先级如下：
 
-所有工具都支持：
+1. `METING_<PLATFORM>_COOKIE`
+2. `METING_COOKIE`
+3. MCP 工具调用时传入的 `cookie`
 
-- `platform`: `netease`、`tencent`、`kugou`、`baidu`、`kuwo`
-- `cookie`: 可选，对应平台 Cookie
+当前支持的环境变量：
 
-各工具额外参数：
+- `METING_NETEASE_COOKIE`
+- `METING_TENCENT_COOKIE`
+- `METING_KUGOU_COOKIE`
+- `METING_BAIDU_COOKIE`
+- `METING_KUWO_COOKIE`
+- `METING_COOKIE`（兜底变量）
 
-- `search`: `keyword`，可选 `type`、`page`、`limit`
-- `song`: `id`
-- `album`: `id`
-- `artist`: `id`，可选 `limit`
-- `playlist`: `id`
-- `url`: `id`，可选 `br`
-- `lyric`: `id`
-- `pic`: `id`，可选 `size`
+如果只需要给某一个平台带 cookie，优先使用对应的平台变量；如果想统一兜底，可以只设置 `METING_COOKIE`
 
-## 版权与致谢
+---
 
-底层核心来自原项目 [metowolf/Meting](https://github.com/metowolf/Meting)，遵循 [MIT](./LICENSE) License。
+关键词: 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,23 +1,24 @@
 {
   "name": "@eldment/meting-mcp",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "MCP server wrapper for the Meting multi-platform music API core.",
   "type": "module",
   "main": "./src/mcp-server.js",
-  "bin": {
-    "meting-mcp": "./src/index.js"
-  },
+  "bin": "./src/index.js",
   "exports": {
     ".": "./src/mcp-server.js"
   },
   "files": [
     "src",
     "README.md",
+    "ACKNOWLEDGEMENTS.md",
     "LICENSE"
   ],
   "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",
@@ -60,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

@@ -4,7 +4,7 @@ import Meting from "./meting.js";
 
 export const serviceMetadata = Object.freeze({
   name: "meting-mcp",
-  version: "1.6.1"
+  version: "1.6.2",
 });
 
 const platformCatalog = Object.freeze([
@@ -12,15 +12,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 +67,9 @@ function CreateTextResult(result, isError = false) {
     content: [
       {
         type: "text",
-        text: JSON.stringify(result, null, 2)
-      }
-    ]
+        text: JSON.stringify(result, null, 2),
+      },
+    ],
   };
 }
 
@@ -57,7 +78,7 @@ function CreateOperationResult(operation, platform, data) {
     ok: true,
     operation,
     platform,
-    data
+    data,
   };
 }
 
@@ -66,15 +87,20 @@ 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,
   };
 }
 
@@ -84,9 +110,9 @@ function RegisterTool(server, toolName, description, inputSchema, handler) {
     {
       title: toolName,
       description,
-      inputSchema
+      inputSchema,
     },
-    async input => {
+    async (input) => {
       try {
         const data = await handler(input);
         return CreateTextResult(CreateOperationResult(toolName, input.platform, data));
@@ -104,12 +130,12 @@ export function CreateMcpServer() {
     "platforms",
     {
       title: "platforms",
-      description: "List supported music platforms."
+      description: "List supported music platforms.",
     },
     async () => {
       return CreateTextResult({
         ok: true,
-        data: platformCatalog
+        data: platformCatalog,
       });
     }
   );
@@ -120,11 +146,16 @@ export function CreateMcpServer() {
     "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 = {};
 
@@ -149,9 +180,9 @@ export function CreateMcpServer() {
     "song",
     "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));
     }
@@ -162,9 +193,9 @@ export function CreateMcpServer() {
     "album",
     "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));
     }
@@ -176,9 +207,9 @@ export function CreateMcpServer() {
     "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));
     }
@@ -189,9 +220,9 @@ export function CreateMcpServer() {
     "playlist",
     "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));
     }
@@ -203,10 +234,11 @@ export function CreateMcpServer() {
     "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);
+      WithCommonInput;
       return ParseResult(await meting.url(input.id, input.br));
     }
   );
@@ -216,9 +248,9 @@ export function CreateMcpServer() {
     "lyric",
     "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));
     }
@@ -230,9 +262,9 @@ export function CreateMcpServer() {
     "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 方法 ==========
 
   // 搜索功能