@eldment/meting-mcp 1.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 METO <i@i-meto.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# @eldment/meting-mcp
+
+`@eldment/meting-mcp` 基于原版 **Meting Node.js** 核心实现，只保留适合 MCP Server 发布与运行的形态。底层支持这些平台：
+
+- `netease`
+- `tencent`
+- `kugou`
+- `baidu`
+- `kuwo`
+
+## 功能概览
+
+- 基于原版 Meting 的统一音乐接口
+- 通过 stdio 暴露为 MCP Server
+- 支持搜索、歌曲、专辑、歌手、歌单、播放链接、歌词、封面等操作
+- 所有 MCP 工具默认返回格式化后的 JSON 文本
+
+## 安装
+
+```bash
+npm install
+```
+
+发布后可直接运行：
+
+```bash
+npx @eldment/meting-mcp
+```
+
+## MCP 接入
+
+示例配置：
+
+```json
+{
+  "mcpServers": {
+    "meting": {
+      "command": "npx",
+      "args": ["-y", "@eldment/meting-mcp"]
+    }
+  }
+}
+```
+
+提供的 MCP 工具：
+
+- `platforms`
+- `search`
+- `song`
+- `album`
+- `artist`
+- `playlist`
+- `url`
+- `lyric`
+- `pic`
+
+## 工具参数
+
+所有工具都支持：
+
+- `platform`: `netease`、`tencent`、`kugou`、`baidu`、`kuwo`
+- `cookie`: 可选，对应平台 Cookie
+
+各工具额外参数：
+
+- `search`: `keyword`，可选 `type`、`page`、`limit`
+- `song`: `id`
+- `album`: `id`
+- `artist`: `id`，可选 `limit`
+- `playlist`: `id`
+- `url`: `id`，可选 `br`
+- `lyric`: `id`
+- `pic`: `id`，可选 `size`
+
+## 版权与致谢
+
+底层核心来自原项目 [metowolf/Meting](https://github.com/metowolf/Meting)，遵循 [MIT](./LICENSE) License。

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@eldment/meting-mcp",
+  "version": "1.6.1",
+  "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"
+  },
+  "exports": {
+    ".": "./src/mcp-server.js"
+  },
+  "files": [
+    "src",
+    "README.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",
+    "test": "node test/test.js",
+    "example": "node test/example.js",
+    "build": "npm pack --dry-run",
+    "verify": "npm run lint && npm test && npm run build",
+    "prepublishOnly": "npm run verify"
+  },
+  "keywords": [
+    "mcp",
+    "music",
+    "api",
+    "netease",
+    "tencent",
+    "kugou",
+    "baidu",
+    "kuwo",
+    "nodejs",
+    "music-api",
+    "search",
+    "lyrics"
+  ],
+  "author": {
+    "name": "ELDment",
+    "url": "https://github.com/ELDment"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/ELDment/Meting-MCP",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ELDment/Meting-MCP.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ELDment/Meting-MCP/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^4.3.6"
+  }
+}

package/src/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CreateMcpServer, serviceMetadata } from "./mcp-server.js";
+
+function GetHelpText() {
+  return [
+    "meting-mcp",
+    "",
+    "MCP server wrapper for the Meting multi-platform music API core.",
+    "",
+    "Usage:",
+    "  meting-mcp            Start the MCP stdio server",
+    "  meting-mcp --help     Show help",
+    "  meting-mcp --version  Show version"
+  ].join("\n");
+}
+
+async function StartServer() {
+  const server = CreateMcpServer();
+  const transport = new StdioServerTransport();
+
+  await server.connect(transport);
+
+  const Shutdown = async () => {
+    await server.close();
+    process.exit(0);
+  };
+
+  process.once("SIGINT", Shutdown);
+  process.once("SIGTERM", Shutdown);
+}
+
+async function Main() {
+  const argumentsList = process.argv.slice(2);
+
+  if (argumentsList.includes("--help") || argumentsList.includes("-h")) {
+    process.stdout.write(`${GetHelpText()}\n`);
+    return;
+  }
+
+  if (argumentsList.includes("--version") || argumentsList.includes("-v")) {
+    process.stdout.write(`${serviceMetadata.version}\n`);
+    return;
+  }
+
+  await StartServer();
+}
+
+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

@@ -0,0 +1,242 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import * as z from "zod/v4";
+import Meting from "./meting.js";
+
+export const serviceMetadata = Object.freeze({
+  name: "meting-mcp",
+  version: "1.6.1"
+});
+
+const platformCatalog = Object.freeze([
+  { name: "NetEase Cloud Music", code: "netease" },
+  { name: "Tencent Music", code: "tencent" },
+  { name: "KuGou Music", code: "kugou" },
+  { name: "Baidu Music", code: "baidu" },
+  { name: "Kuwo Music", code: "kuwo" }
+]);
+
+const platformSchema = z.enum(Meting.getSupportedPlatforms());
+
+function CreateClient(platform, cookie) {
+  const meting = new Meting(platform);
+  meting.format(true);
+
+  if (cookie) {
+    meting.cookie(cookie);
+  }
+
+  return meting;
+}
+
+function ParseResult(rawValue) {
+  if (typeof rawValue !== "string") {
+    return rawValue;
+  }
+
+  try {
+    return JSON.parse(rawValue);
+  } catch {
+    return { raw: rawValue };
+  }
+}
+
+function CreateTextResult(result, isError = false) {
+  return {
+    isError,
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(result, null, 2)
+      }
+    ]
+  };
+}
+
+function CreateOperationResult(operation, platform, data) {
+  return {
+    ok: true,
+    operation,
+    platform,
+    data
+  };
+}
+
+function CreateOperationError(operation, platform, error) {
+  return {
+    ok: false,
+    operation,
+    platform,
+    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
+  };
+}
+
+function RegisterTool(server, toolName, description, inputSchema, handler) {
+  server.registerTool(
+    toolName,
+    {
+      title: toolName,
+      description,
+      inputSchema
+    },
+    async input => {
+      try {
+        const data = await handler(input);
+        return CreateTextResult(CreateOperationResult(toolName, input.platform, data));
+      } catch (error) {
+        return CreateTextResult(CreateOperationError(toolName, input.platform, error), true);
+      }
+    }
+  );
+}
+
+export function CreateMcpServer() {
+  const server = new McpServer(serviceMetadata);
+
+  server.registerTool(
+    "platforms",
+    {
+      title: "platforms",
+      description: "List supported music platforms."
+    },
+    async () => {
+      return CreateTextResult({
+        ok: true,
+        data: platformCatalog
+      });
+    }
+  );
+
+  RegisterTool(
+    server,
+    "search",
+    "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."),
+      page: z.number().int().positive().optional().describe("Optional page number."),
+      limit: z.number().int().positive().max(100).optional().describe("Optional page size.")
+    }),
+    async input => {
+      const meting = CreateClient(input.platform, input.cookie);
+      const options = {};
+
+      if (input.type !== undefined) {
+        options.type = input.type;
+      }
+
+      if (input.page !== undefined) {
+        options.page = input.page;
+      }
+
+      if (input.limit !== undefined) {
+        options.limit = input.limit;
+      }
+
+      return ParseResult(await meting.search(input.keyword, options));
+    }
+  );
+
+  RegisterTool(
+    server,
+    "song",
+    "Get song detail by id.",
+    WithCommonInput({
+      id: z.string().min(1).describe("Song id.")
+    }),
+    async input => {
+      const meting = CreateClient(input.platform, input.cookie);
+      return ParseResult(await meting.song(input.id));
+    }
+  );
+
+  RegisterTool(
+    server,
+    "album",
+    "Get album detail by id.",
+    WithCommonInput({
+      id: z.string().min(1).describe("Album id.")
+    }),
+    async input => {
+      const meting = CreateClient(input.platform, input.cookie);
+      return ParseResult(await meting.album(input.id));
+    }
+  );
+
+  RegisterTool(
+    server,
+    "artist",
+    "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.")
+    }),
+    async input => {
+      const meting = CreateClient(input.platform, input.cookie);
+      return ParseResult(await meting.artist(input.id, input.limit));
+    }
+  );
+
+  RegisterTool(
+    server,
+    "playlist",
+    "Get playlist detail by id.",
+    WithCommonInput({
+      id: z.string().min(1).describe("Playlist id.")
+    }),
+    async input => {
+      const meting = CreateClient(input.platform, input.cookie);
+      return ParseResult(await meting.playlist(input.id));
+    }
+  );
+
+  RegisterTool(
+    server,
+    "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.")
+    }),
+    async input => {
+      const meting = CreateClient(input.platform, input.cookie);
+      return ParseResult(await meting.url(input.id, input.br));
+    }
+  );
+
+  RegisterTool(
+    server,
+    "lyric",
+    "Get song lyric by id.",
+    WithCommonInput({
+      id: z.string().min(1).describe("Song id.")
+    }),
+    async input => {
+      const meting = CreateClient(input.platform, input.cookie);
+      return ParseResult(await meting.lyric(input.id));
+    }
+  );
+
+  RegisterTool(
+    server,
+    "pic",
+    "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.")
+    }),
+    async input => {
+      const meting = CreateClient(input.platform, input.cookie);
+      return ParseResult(await meting.pic(input.id, input.size));
+    }
+  );
+
+  return server;
+}

package/src/meting.js

@@ -0,0 +1,192 @@
+/**
+ * Meting music framework - Node.js version (重构版本)
+ * https://i-meto.com
+ * https://github.com/metowolf/Meting
+ *
+ * Copyright 2019, METO Sheel <i@i-meto.com>
+ * Released under the MIT license
+ */
+
+import { URLSearchParams } from 'url';
+import ProviderFactory from './providers/index.js';
+
+class Meting {
+  constructor(server = 'netease') {
+    this.VERSION = '__VERSION__'; // 在构建时由 rollup 替换为实际版本号
+    this.raw = null;
+    this.info = null;
+    this.error = null;
+    this.status = null;
+    this.temp = {};
+
+    this.server = null;
+    this.provider = null;
+    this.isFormat = false;
+    this.header = {};
+
+    this.site(server);
+  }
+
+  // 设置音乐平台
+  site(server) {
+    if (!ProviderFactory.isSupported(server)) {
+      server = 'netease'; // 默认使用网易云音乐
+    }
+
+    this.server = server;
+    this.provider = ProviderFactory.create(server, this);
+    this.header = this.provider.getHeaders();
+
+    return this;
+  }
+
+  // 设置 Cookie
+  cookie(cookie) {
+    this.header['Cookie'] = cookie;
+    return this;
+  }
+
+  // 设置数据格式化
+  format(format = true) {
+    this.isFormat = format;
+    return this;
+  }
+
+  // 执行 API 请求的主方法
+  async _exec(api) {
+    // 让 Provider 自己处理完整的请求流程
+    return await this.provider.executeRequest(api, this);
+  }
+
+  // HTTP 请求方法 - 使用 fetch API
+  async _curl(url, payload = null, headerOnly = false) {
+    const requestOptions = {
+      method: payload ? 'POST' : 'GET',
+      headers: { ...this.header }
+    };
+
+    // 处理请求体
+    if (payload) {
+      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.body = payload;
+    }
+
+    // 添加超时控制
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 20000);
+    requestOptions.signal = controller.signal;
+
+    let retries = 3;
+    const makeRequest = async () => {
+      try {
+        const response = await fetch(url, requestOptions);
+        
+        clearTimeout(timeoutId);
+        
+        // 存储响应信息
+        this.info = {
+          statusCode: response.status,
+          headers: Object.fromEntries(response.headers.entries())
+        };
+
+        // 获取响应数据
+        const data = await response.text();
+        this.raw = data;
+        this.error = null;
+        this.status = '';
+        
+        return this;
+      } catch (err) {
+        clearTimeout(timeoutId);
+        
+        // 处理错误
+        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));
+          return makeRequest();
+        } else {
+          return this;
+        }
+      }
+    };
+
+    return await makeRequest();
+  }
+
+
+  // ========== 公共 API 方法 ==========
+
+  // 搜索功能
+  async search(keyword, option = {}) {
+    const api = this.provider.search(keyword, option);
+    return await this._exec(api);
+  }
+
+  // 获取歌曲详情
+  async song(id) {
+    const api = this.provider.song(id);
+    return await this._exec(api);
+  }
+
+  // 获取专辑信息
+  async album(id) {
+    const api = this.provider.album(id);
+    return await this._exec(api);
+  }
+
+  // 获取艺术家作品
+  async artist(id, limit = 50) {
+    const api = this.provider.artist(id, limit);
+    return await this._exec(api);
+  }
+
+  // 获取播放列表
+  async playlist(id) {
+    const api = this.provider.playlist(id);
+    return await this._exec(api);
+  }
+
+  // 获取音频播放链接
+  async url(id, br = 320) {
+    this.temp.br = br;
+    const api = this.provider.url(id, br);
+    return await this._exec(api);
+  }
+
+  // 获取歌词
+  async lyric(id) {
+    const api = this.provider.lyric(id);
+    return await this._exec(api);
+  }
+
+  // 获取封面图片
+  async pic(id, size = 300) {
+    return await this.provider.pic(id, size);
+  }
+
+  // ========== 静态方法 ==========
+
+  // 获取支持的平台列表
+  static getSupportedPlatforms() {
+    return ProviderFactory.getSupportedPlatforms();
+  }
+
+  // 检查平台是否支持
+  static isSupported(platform) {
+    return ProviderFactory.isSupported(platform);
+  }
+}
+
+export default Meting;