@mseep/mmx-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 bingking
+
+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,140 @@
+# mmx-mcp-server
+
+一个统一的 MiniMax 全模态 MCP Server，基于 `mmx` CLI 封装，支持文本、搜索、图像理解、图像生成、语音合成、视频生成、音乐生成和配额查询。
+
+![Preview](assets/preview.png)
+
+> [English README](README_EN.md)
+
+## 快速开始（一句话配置）
+
+如果你使用的是 Claude Code、OpenCode 或其他支持 MCP 的 AI CLI 工具，直接把下面这段话丢给 AI：
+
+> 帮我安装并配置 mmx-mcp-server：
+> 1. 全局安装 mmx-cli（`npm install -g mmx-cli`）
+> 2. 克隆 https://github.com/zth0828/mmx-mcp-server 到任意目录，执行 `npm install && npm run build`
+> 3. 在我的 MCP 配置文件（如 `~/.claude/settings.json`）里添加 `mmx` server，指向构建产物 `dist/index.js`
+> 4. 向我要 MiniMax API Key，并通过 `env.MINIMAX_API_KEY` 注入
+> 5. 完成后告诉我配置结果
+
+---
+
+## 手动安装
+
+### 1. 安装 mmx CLI（如果尚未安装）
+
+```bash
+npm install -g mmx-cli
+```
+
+验证安装：
+
+```bash
+mmx --version
+```
+
+### 2. 安装并构建 MCP Server
+
+```bash
+git clone https://github.com/zth0828/mmx-mcp-server.git
+cd mmx-mcp-server
+npm install
+npm run build
+```
+
+### 3. 配置 API Key
+
+在 MCP 客户端配置（如 `~/.claude/settings.json`）中添加：
+
+#### 方式一：环境变量传 API Key（推荐）
+
+```json
+{
+  "mcpServers": {
+    "mmx": {
+      "command": "node",
+      "args": ["/path/to/mmx-mcp-server/dist/index.js"],
+      "env": {
+        "MINIMAX_API_KEY": "sk-xxxxx"
+      }
+    }
+  }
+}
+```
+
+#### 方式二：命令行参数传 API Key
+
+适合不方便写 `env` 的 MCP 客户端：
+
+```json
+{
+  "mcpServers": {
+    "mmx": {
+      "command": "node",
+      "args": [
+        "/path/to/mmx-mcp-server/dist/index.js",
+        "--api-key",
+        "sk-xxxxx"
+      ]
+    }
+  }
+}
+```
+
+#### 方式三：依赖 `mmx` CLI 本地登录
+
+如果前两种方式都没配，Server 会自动回退到 `mmx` CLI 自身的认证状态（需提前执行 `mmx auth login --api-key sk-xxxxx`）。这种方式仅适合本机使用。
+
+---
+
+### 自定义输出目录（可选）
+
+默认情况下，生成的图片、视频、音乐、语音会自动保存到 **当前工作目录** 下的子文件夹：
+
+- `mmx_image/` — 图片
+- `mmx_video/` — 视频
+- `mmx_music/` — 音乐
+- `mmx_speech/` — 语音
+
+如果你希望统一放到其他位置，可以通过环境变量 `MMX_OUTPUT_DIR` 修改：
+
+```json
+{
+  "mcpServers": {
+    "mmx": {
+      "command": "node",
+      "args": ["/path/to/mmx-mcp-server/dist/index.js"],
+      "env": {
+        "MINIMAX_API_KEY": "sk-xxxxx",
+        "MMX_OUTPUT_DIR": "/Users/xxx/Downloads/mmx-output"
+      }
+    }
+  }
+}
+```
+
+> 不配置 `MMX_OUTPUT_DIR` 也完全不影响使用，文件会自动落在当前项目目录下。
+
+每次调用时也可以通过 `out` 参数指定单个文件的输出路径。
+
+## 提供的 Tools
+
+| Tool | 说明 |
+|------|------|
+| `mmx_search` | 网页搜索 |
+| `mmx_vision_describe` | 图像理解（支持自定义分析指令，如 UI critique） |
+| `mmx_text_chat` | 文本对话（支持 system prompt、JSON 模式） |
+| `mmx_image_generate` | 图像生成（支持 `out` 指定路径） |
+| `mmx_speech_synthesize` | 语音合成 TTS（支持 `out` 指定路径） |
+| `mmx_video_generate` | 视频生成（支持 `out` 指定路径） |
+| `mmx_music_generate` | 音乐生成（支持 `out` 指定路径） |
+| `mmx_quota_show` | 查看配额 |
+
+## 使用示例
+
+配置完成后，你可以在 Claude Code 中直接说：
+
+> "帮我搜索 MiniMax 的最新新闻"  
+> "分析一下这个 UI 设计图，给出优化建议"  
+> "生成一张赛博朋克风格的城市夜景图"  
+> "把这段文字转成语音"

package/README_EN.md

@@ -0,0 +1,140 @@
+# mmx-mcp-server
+
+A unified Model Context Protocol (MCP) server for MiniMax, wrapping the `mmx` CLI. Supports text chat, web search, vision understanding, image generation, speech synthesis, video generation, music generation, and quota queries.
+
+![Preview](assets/preview.png)
+
+> [中文 README](README.md)
+
+## Quick Start (One-sentence setup)
+
+If you are using Claude Code, OpenCode, or any other AI CLI tool that supports MCP, simply paste the following prompt to your assistant:
+
+> Please install and configure mmx-mcp-server for me:
+> 1. Globally install mmx-cli (`npm install -g mmx-cli`)
+> 2. Clone https://github.com/zth0828/mmx-mcp-server to any directory and run `npm install && npm run build`
+> 3. Add an `mmx` server entry to my MCP config file (e.g. `~/.claude/settings.json`) pointing to the built artifact `dist/index.js`
+> 4. Ask me for my MiniMax API Key and inject it via `env.MINIMAX_API_KEY`
+> 5. Tell me the result when done
+
+---
+
+## Manual Installation
+
+### 1. Install mmx CLI (if not already installed)
+
+```bash
+npm install -g mmx-cli
+```
+
+Verify installation:
+
+```bash
+mmx --version
+```
+
+### 2. Install and build the MCP Server
+
+```bash
+git clone https://github.com/zth0828/mmx-mcp-server.git
+cd mmx-mcp-server
+npm install
+npm run build
+```
+
+### 3. Configure the API Key
+
+Add the following to your MCP client settings (e.g. `~/.claude/settings.json` under `mcpServers`):
+
+#### Option 1: API Key via Environment Variable (Recommended)
+
+```json
+{
+  "mcpServers": {
+    "mmx": {
+      "command": "node",
+      "args": ["/path/to/mmx-mcp-server/dist/index.js"],
+      "env": {
+        "MINIMAX_API_KEY": "sk-xxxxx"
+      }
+    }
+  }
+}
+```
+
+#### Option 2: API Key via Command-Line Arguments
+
+Useful for MCP clients that do not support `env`:
+
+```json
+{
+  "mcpServers": {
+    "mmx": {
+      "command": "node",
+      "args": [
+        "/path/to/mmx-mcp-server/dist/index.js",
+        "--api-key",
+        "sk-xxxxx"
+      ]
+    }
+  }
+}
+```
+
+#### Option 3: Fallback to `mmx` CLI Local Auth
+
+If no API key is provided via MCP config, the server falls back to the `mmx` CLI's own authentication state (requires prior `mmx auth login --api-key sk-xxxxx`). This is only suitable for local usage.
+
+---
+
+### Custom Output Directory (Optional)
+
+By default, generated images, videos, music, and speech are saved into subdirectories under the **current working directory**:
+
+- `mmx_image/` — Images
+- `mmx_video/` — Videos
+- `mmx_music/` — Music
+- `mmx_speech/` — Speech
+
+You can change the base output directory with the `MMX_OUTPUT_DIR` environment variable:
+
+```json
+{
+  "mcpServers": {
+    "mmx": {
+      "command": "node",
+      "args": ["/path/to/mmx-mcp-server/dist/index.js"],
+      "env": {
+        "MINIMAX_API_KEY": "sk-xxxxx",
+        "MMX_OUTPUT_DIR": "/Users/xxx/Downloads/mmx-output"
+      }
+    }
+  }
+}
+```
+
+> Not setting `MMX_OUTPUT_DIR` is perfectly fine — files will simply land under your current project directory.
+
+You can also specify an individual output path on each tool call via the `out` parameter.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `mmx_search` | Web search |
+| `mmx_vision_describe` | Image understanding with custom instructions (e.g. UI critique) |
+| `mmx_text_chat` | Text chat (supports system prompt & JSON mode) |
+| `mmx_image_generate` | Image generation (supports `out` path) |
+| `mmx_speech_synthesize` | Text-to-speech (supports `out` path) |
+| `mmx_video_generate` | Video generation (supports `out` path) |
+| `mmx_music_generate` | Music generation (supports `out` path) |
+| `mmx_quota_show` | Show usage quotas |
+
+## Usage Examples
+
+Once configured, you can ask your AI assistant directly:
+
+> "Search for the latest MiniMax news"  
+> "Analyze this UI screenshot and give me improvement suggestions"  
+> "Generate a cyberpunk city nightscape image"  
+> "Turn this paragraph into speech"

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,538 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { spawn, execSync } from "child_process";
+import { mkdir, mkdtemp, readdir } from "fs/promises";
+import { tmpdir } from "os";
+import { join, resolve } from "path";
+const COMMON_ARGS = ["--output", "json", "--non-interactive", "--quiet"];
+const argsIndex = process.argv.indexOf("--api-key");
+const API_KEY = argsIndex !== -1
+    ? process.argv[argsIndex + 1]
+    : process.env.MINIMAX_API_KEY || process.env.MCP_MINIMAX_API_KEY || undefined;
+const API_KEY_ARGS = API_KEY ? ["--api-key", API_KEY] : [];
+const DEFAULT_OUTPUT_BASE = process.env.MMX_OUTPUT_DIR || process.cwd();
+const TOOL_OUTPUT_SUBDIR = {
+    mmx_image_generate: "mmx_image",
+    mmx_video_generate: "mmx_video",
+    mmx_music_generate: "mmx_music",
+    mmx_speech_synthesize: "mmx_speech",
+};
+function getDefaultOutputDir(toolName) {
+    const subdir = TOOL_OUTPUT_SUBDIR[toolName] || "mmx_output";
+    return resolve(DEFAULT_OUTPUT_BASE, subdir);
+}
+async function runMmx(args, cwd) {
+    return new Promise((res, rej) => {
+        const child = spawn("mmx", [...API_KEY_ARGS, ...COMMON_ARGS, ...args], {
+            cwd,
+            env: process.env,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (data) => {
+            stdout += data.toString("utf-8");
+        });
+        child.stderr.on("data", (data) => {
+            stderr += data.toString("utf-8");
+        });
+        child.on("close", (code) => {
+            res({ stdout, stderr, exitCode: code ?? 0 });
+        });
+        child.on("error", rej);
+    });
+}
+async function runMmxWithFiles(args, outputDir) {
+    const dir = outputDir || (await mkdtemp(join(tmpdir(), "mmx-mcp-")));
+    if (outputDir) {
+        await mkdir(outputDir, { recursive: true });
+    }
+    const result = await runMmx(args, dir);
+    const files = (await readdir(dir)).map((f) => join(dir, f));
+    return { ...result, files, tempDir: dir };
+}
+function parseJsonSafe(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+const server = new Server({
+    name: "mmx-mcp-server",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "mmx_search",
+                description: "Search the web using MiniMax. Returns search results with titles, snippets, and URLs. Use this when you need up-to-date information, facts, news, or references from the internet.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "Search query. Be specific for better results.",
+                        },
+                    },
+                    required: ["query"],
+                },
+            },
+            {
+                name: "mmx_vision_describe",
+                description: "Analyze an image with a custom instruction using MiniMax Vision. Useful for: UI/UX critique, extracting text, identifying objects, evaluating designs, or answering specific questions about the image.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        image: {
+                            type: "string",
+                            description: "Local file path or URL to the image. Base64 encoding is handled automatically.",
+                        },
+                        prompt: {
+                            type: "string",
+                            description: "Instruction or question about the image. Examples: 'Give me UX improvement suggestions for this UI', 'Extract all visible text', 'What is wrong with this layout?', 'Describe the image in detail'. Defaults to 'Describe the image.'",
+                        },
+                    },
+                    required: ["image"],
+                },
+            },
+            {
+                name: "mmx_text_chat",
+                description: "Chat with MiniMax text models. Supports system prompts and optional JSON mode. Use this for general reasoning, writing, coding help, or structured output.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        message: {
+                            type: "string",
+                            description: "The user message to send to the model",
+                        },
+                        system: {
+                            type: "string",
+                            description: "Optional system prompt to set the model's behavior or persona",
+                        },
+                        json: {
+                            type: "boolean",
+                            description: "If true, requests the model to output valid JSON. You should still explicitly ask for JSON in the message or system prompt.",
+                        },
+                    },
+                    required: ["message"],
+                },
+            },
+            {
+                name: "mmx_image_generate",
+                description: "Generate images with MiniMax. If no output path is provided, images are saved to the default output directory (e.g. ./mmx_image) and their file paths are returned.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        prompt: {
+                            type: "string",
+                            description: "Detailed description of the image you want to generate",
+                        },
+                        aspect_ratio: {
+                            type: "string",
+                            description: "Optional aspect ratio. Supported: 16:9, 1:1, 4:3. Default: 1:1",
+                        },
+                        n: {
+                            type: "number",
+                            description: "Optional number of images to generate. Default: 1",
+                        },
+                        out: {
+                            type: "string",
+                            description: "Optional custom output file path or directory. If omitted, uses the default directory",
+                        },
+                    },
+                    required: ["prompt"],
+                },
+            },
+            {
+                name: "mmx_speech_synthesize",
+                description: "Synthesize speech with MiniMax TTS. Converts text into an audio file. If no output path is provided, the file is saved to the default output directory (e.g. ./mmx_speech).",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        text: {
+                            type: "string",
+                            description: "The text to convert to speech",
+                        },
+                        voice: {
+                            type: "string",
+                            description: "Optional voice ID. Default depends on the model",
+                        },
+                        speed: {
+                            type: "number",
+                            description: "Optional speech speed multiplier (e.g. 0.8 - 1.5)",
+                        },
+                        out: {
+                            type: "string",
+                            description: "Optional output file path. If omitted, a temp file path is returned",
+                        },
+                    },
+                    required: ["text"],
+                },
+            },
+            {
+                name: "mmx_video_generate",
+                description: "Generate video with MiniMax from a text prompt. If no output path is provided, the video is saved to the default output directory (e.g. ./mmx_video) and its file path is returned.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        prompt: {
+                            type: "string",
+                            description: "Detailed description of the video scene you want to generate",
+                        },
+                        duration: {
+                            type: "number",
+                            description: "Optional duration in seconds. Check model limits for max duration",
+                        },
+                        resolution: {
+                            type: "string",
+                            description: "Optional resolution. Example: 768p",
+                        },
+                        out: {
+                            type: "string",
+                            description: "Optional custom output file path. If omitted, uses the default directory",
+                        },
+                    },
+                    required: ["prompt"],
+                },
+            },
+            {
+                name: "mmx_music_generate",
+                description: "Generate music with MiniMax. Supports instrumental or vocal music. If lyrics and style are provided, generates a song. If no output path is provided, the audio file is saved to the default output directory (e.g. ./mmx_music).",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        prompt: {
+                            type: "string",
+                            description: "Description of the music you want (mood, genre, instruments, scene)",
+                        },
+                        lyrics: {
+                            type: "string",
+                            description: "Optional lyrics content. If provided, the model will attempt to generate a vocal track",
+                        },
+                        style: {
+                            type: "string",
+                            description: "Optional music style or genre hint (e.g. 'pop', 'classical piano', 'electronic')",
+                        },
+                        out: {
+                            type: "string",
+                            description: "Optional output file path. If omitted, a temp file path is returned",
+                        },
+                    },
+                    required: ["prompt"],
+                },
+            },
+            {
+                name: "mmx_quota_show",
+                description: "Show MiniMax usage quotas and remaining limits for each model or service.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+        ],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    try {
+        switch (name) {
+            case "mmx_search": {
+                const { query } = args;
+                const { stdout, stderr, exitCode } = await runMmx([
+                    "search",
+                    "query",
+                    query,
+                ]);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: exitCode === 0
+                                ? JSON.stringify(parseJsonSafe(stdout), null, 2)
+                                : stderr || stdout || `Exit code: ${exitCode}`,
+                        },
+                    ],
+                };
+            }
+            case "mmx_vision_describe": {
+                const { image, prompt } = args;
+                const cmdArgs = ["vision", "describe", "--image", image];
+                if (prompt)
+                    cmdArgs.push("--prompt", prompt);
+                const { stdout, stderr, exitCode } = await runMmx(cmdArgs);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: exitCode === 0
+                                ? JSON.stringify(parseJsonSafe(stdout), null, 2)
+                                : stderr || stdout || `Exit code: ${exitCode}`,
+                        },
+                    ],
+                };
+            }
+            case "mmx_text_chat": {
+                const { message, system, json } = args;
+                const cmdArgs = ["text", "chat", "--message", message];
+                if (system)
+                    cmdArgs.push("--system", system);
+                if (json)
+                    cmdArgs.push("--json");
+                const { stdout, stderr, exitCode } = await runMmx(cmdArgs);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: exitCode === 0
+                                ? JSON.stringify(parseJsonSafe(stdout), null, 2)
+                                : stderr || stdout || `Exit code: ${exitCode}`,
+                        },
+                    ],
+                };
+            }
+            case "mmx_quota_show": {
+                const { stdout, stderr, exitCode } = await runMmx(["quota", "show"]);
+                if (exitCode !== 0) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: stderr || stdout || `Exit code: ${exitCode}`,
+                            },
+                        ],
+                    };
+                }
+                const data = parseJsonSafe(stdout);
+                if (typeof data === "string") {
+                    return {
+                        content: [{ type: "text", text: data }],
+                    };
+                }
+                const remains = data?.model_remains || [];
+                const lines = [];
+                lines.push("MiniMax TokenPlan 配额面板");
+                lines.push("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+                for (const item of remains) {
+                    const total = item.current_interval_total_count ?? 0;
+                    // API 的 usage_count 实际是剩余次数（字段名有误）
+                    const remaining = item.current_interval_usage_count ?? 0;
+                    const used = total - remaining;
+                    const name = item.model_name ?? "Unknown";
+                    lines.push(`${name.padEnd(36)} ${used} / ${total}`);
+                }
+                lines.push("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+                lines.push("注：X / Y 中 X 为已使用次数，Y 为周期总额度");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: lines.join("\n"),
+                        },
+                    ],
+                };
+            }
+            case "mmx_image_generate": {
+                const { prompt, aspect_ratio, n, out } = args;
+                const cmdArgs = ["image", prompt];
+                if (aspect_ratio)
+                    cmdArgs.push("--aspect-ratio", aspect_ratio);
+                if (n !== undefined)
+                    cmdArgs.push("--n", String(n));
+                const outputDir = out ? undefined : getDefaultOutputDir("mmx_image_generate");
+                const { stdout, stderr, exitCode, files } = await runMmxWithFiles(cmdArgs, outputDir);
+                const data = parseJsonSafe(stdout);
+                const textParts = [];
+                if (exitCode !== 0) {
+                    textParts.push(stderr || stdout || `Exit code: ${exitCode}`);
+                }
+                else {
+                    textParts.push(JSON.stringify(data, null, 2));
+                }
+                const outputFiles = out ? [resolve(out)] : files;
+                if (outputFiles.length > 0) {
+                    textParts.push("\nGenerated files:");
+                    outputFiles.forEach((f) => textParts.push(`- ${f}`));
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: textParts.join("\n"),
+                        },
+                    ],
+                };
+            }
+            case "mmx_speech_synthesize": {
+                const { text, voice, speed, out } = args;
+                const cmdArgs = ["speech", "synthesize", "--text", text];
+                if (voice)
+                    cmdArgs.push("--voice", voice);
+                if (speed !== undefined)
+                    cmdArgs.push("--speed", String(speed));
+                if (out)
+                    cmdArgs.push("--out", resolve(out));
+                const outputDir = out
+                    ? undefined
+                    : getDefaultOutputDir("mmx_speech_synthesize");
+                const { stdout, stderr, exitCode, files } = await runMmxWithFiles(cmdArgs, outputDir);
+                const data = parseJsonSafe(stdout);
+                const textParts = [];
+                if (exitCode !== 0) {
+                    textParts.push(stderr || stdout || `Exit code: ${exitCode}`);
+                }
+                else {
+                    textParts.push(JSON.stringify(data, null, 2));
+                }
+                const outputFiles = out ? [resolve(out)] : files;
+                if (outputFiles.length > 0) {
+                    textParts.push("\nGenerated files:");
+                    outputFiles.forEach((f) => textParts.push(`- ${f}`));
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: textParts.join("\n"),
+                        },
+                    ],
+                };
+            }
+            case "mmx_video_generate": {
+                const { prompt, duration, resolution, out } = args;
+                const cmdArgs = ["video", "generate", "--prompt", prompt];
+                if (duration !== undefined)
+                    cmdArgs.push("--duration", String(duration));
+                if (resolution)
+                    cmdArgs.push("--resolution", resolution);
+                if (out)
+                    cmdArgs.push("--out", resolve(out));
+                const outputDir = out
+                    ? undefined
+                    : getDefaultOutputDir("mmx_video_generate");
+                const { stdout, stderr, exitCode, files } = await runMmxWithFiles(cmdArgs, outputDir);
+                const data = parseJsonSafe(stdout);
+                const textParts = [];
+                if (exitCode !== 0) {
+                    textParts.push(stderr || stdout || `Exit code: ${exitCode}`);
+                }
+                else {
+                    textParts.push(JSON.stringify(data, null, 2));
+                }
+                const outputFiles = out ? [resolve(out)] : files;
+                if (outputFiles.length > 0) {
+                    textParts.push("\nGenerated files:");
+                    outputFiles.forEach((f) => textParts.push(`- ${f}`));
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: textParts.join("\n"),
+                        },
+                    ],
+                };
+            }
+            case "mmx_music_generate": {
+                const { prompt, lyrics, style, out } = args;
+                const cmdArgs = ["music", "generate", "--prompt", prompt];
+                if (lyrics)
+                    cmdArgs.push("--lyrics", lyrics);
+                if (style)
+                    cmdArgs.push("--style", style);
+                if (out)
+                    cmdArgs.push("--out", resolve(out));
+                const outputDir = out
+                    ? undefined
+                    : getDefaultOutputDir("mmx_music_generate");
+                const { stdout, stderr, exitCode, files } = await runMmxWithFiles(cmdArgs, outputDir);
+                const data = parseJsonSafe(stdout);
+                const textParts = [];
+                if (exitCode !== 0) {
+                    textParts.push(stderr || stdout || `Exit code: ${exitCode}`);
+                }
+                else {
+                    textParts.push(JSON.stringify(data, null, 2));
+                }
+                const outputFiles = out ? [resolve(out)] : files;
+                if (outputFiles.length > 0) {
+                    textParts.push("\nGenerated files:");
+                    outputFiles.forEach((f) => textParts.push(`- ${f}`));
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: textParts.join("\n"),
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${err.message || String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+function ensureMmxCli() {
+    try {
+        execSync("mmx --version", { stdio: "ignore" });
+    }
+    catch {
+        console.error("Error: mmx CLI not found. Please install it first: npm install -g mmx-cli");
+        process.exit(1);
+    }
+}
+function handleCliArgs() {
+    if (process.argv.includes("--help") || process.argv.includes("-h")) {
+        console.log(`mmx-mcp-server v1.0.0
+
+A unified MCP server for MiniMax CLI (mmx).
+
+Usage:
+  node dist/index.js [options]
+
+Options:
+  --api-key <key>    Pass MiniMax API key via command line
+  --help, -h         Show this help message
+  --version          Show version number
+
+Environment Variables:
+  MINIMAX_API_KEY      MiniMax API key (recommended)
+  MCP_MINIMAX_API_KEY  Alternative API key variable
+  MMX_OUTPUT_DIR       Base directory for generated files
+`);
+        process.exit(0);
+    }
+    if (process.argv.includes("--version") || process.argv.includes("-v")) {
+        console.log("1.0.0");
+        process.exit(0);
+    }
+}
+async function main() {
+    handleCliArgs();
+    ensureMmxCli();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@mseep/mmx-mcp-server",
+  "version": "1.0.0",
+  "description": "A unified Model Context Protocol server for MiniMax CLI (mmx)",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "mmx-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README_EN.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "minimax",
+    "mmx",
+    "ai",
+    "multimodal",
+    "mseep",
+    "mcp-server"
+  ],
+  "author": "bingking <zth285130@163.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zth0828/mmx-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zth0828/mmx-mcp-server/issues"
+  },
+  "homepage": "https://github.com/zth0828/mmx-mcp-server#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "publisher": "mseep"
+}