mmx-mcp-server

A unified MiniMax multimodal MCP Server, wrapped based on the mmx CLI, supporting text, search, image understanding, image generation, speech synthesis, video generation, music generation, and quota queries.

English README

Quick Start (One-sentence configuration)

If you are using Claude Code, OpenCode, or other AI CLI tools that support MCP, simply provide the following prompt to the AI:

Help me install and configure mmx-mcp-server:

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 the mmx server to my MCP configuration file (e.g., ~/.claude/settings.json), pointing to the build artifact dist/index.js

4. Ask me for my MiniMax API Key and inject it via env.MINIMAX_API_KEY

5. Tell me the configuration result once finished

Related MCP server: MiniMax Unified MCP

Manual Installation

1. Install mmx CLI (if not already installed)

npm install -g mmx-cli

Verify the installation:

mmx --version

2. Install and build the MCP Server

git clone https://github.com/zth0828/mmx-mcp-server.git
cd mmx-mcp-server
npm install
npm run build

3. Configure API Key

Add the following to your MCP client configuration (e.g., ~/.claude/settings.json):

Method 1: Pass API Key via environment variables (Recommended)

{
  "mcpServers": {
    "mmx": {
      "command": "node",
      "args": ["/path/to/mmx-mcp-server/dist/index.js"],
      "env": {
        "MINIMAX_API_KEY": "sk-xxxxx"
      }
    }
  }
}

Method 2: Pass API Key via command-line arguments

Suitable for MCP clients where setting env is inconvenient:

{
  "mcpServers": {
    "mmx": {
      "command": "node",
      "args": [
        "/path/to/mmx-mcp-server/dist/index.js",
        "--api-key",
        "sk-xxxxx"
      ]
    }
  }
}

Method 3: Rely on mmx CLI local login

If neither of the first two methods is configured, the Server will automatically fall back to the authentication state of the mmx CLI itself (requires running mmx auth login --api-key sk-xxxxx beforehand). This method is only suitable for local machine use.

Custom Output Directory (Optional)

By default, generated images, videos, music, and speech are automatically saved to subfolders in the current working directory:

• mmx_image/ — Images

• mmx_video/ — Videos

• mmx_music/ — Music

• mmx_speech/ — Speech

If you wish to store them in a different location, you can modify it via the MMX_OUTPUT_DIR environment variable:

{
  "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 configuring MMX_OUTPUT_DIR will not affect usage; files will simply be placed in the current project directory.

You can also specify the output path for individual files using the out parameter during each call.

Provided Tools

Usage Examples

Once configured, you can directly say in Claude Code:

"Help me search for the latest news about MiniMax" "Analyze this UI design and provide optimization suggestions" "Generate a cyberpunk-style city night view image" "Convert this text to speech"