# MiniMax-MCP

> MCP Server

MiniMax MCP server: Enables TTS, image & video generation API access. Facilitates model interaction.

## Overview

- **Category:** Communication
- **Language:** Python
- **Stars:** 1566
- **Forks:** 121
- **Owner:** MiniMax-AI
- **GitHub:** https://github.com/MiniMax-AI/MiniMax-MCP
- **Homepage:** https://www.minimax.io/platform
- **Created:** 2025-04-10T06:15:56+00:00
- **Updated:** 2025-07-07T13:25:31+00:00
- **Source:** https://model-context-protocol.com/servers/minimax-mcp

## Setup

## Setup

This guide outlines the steps to set up the MiniMax Model Context Protocol (MCP) server for use with MCP clients like Claude Desktop and Cursor.

### Prerequisites

*   **MiniMax API Key:** Obtain your API key from the [MiniMax Platform](https://www.minimax.io/platform/user-center/basic-information/interface-key) (Global) or [MiniMax Mainland Platform](https://platform.minimaxi.com/user-center/basic-information/interface-key), depending on your region.
*   **Python Package Manager (uv):** Install `uv` using the following command:

    ```bash
    curl -LsSf https://astral.sh/uv/install.sh | sh
    ```

    Refer to the [uv repository](https://github.com/astral-sh/uv) for alternative installation methods.

### Installation

The `minimax-mcp` package is installed and managed by `uv`.  The specific installation is handled within the configuration of your MCP client (e.g., Claude Desktop, Cursor).  The configurations below effectively trigger the installation if it's not already present.

### Configuration

The configuration process varies depending on the MCP client you are using.  Below are instructions for Claude Desktop and Cursor.

#### Claude Desktop

1.  Navigate to `Claude > Settings > Developer > Edit Config > claude_desktop_config.json`.
2.  Add the following configuration within the `mcpServers` section:

    ```json
    {
      "mcpServers": {
        "MiniMax": {
          "command": "uvx",
          "args": [
            "minimax-mcp",
            "-y"
          ],
          "env": {
            "MINIMAX_API_KEY": "YOUR_API_KEY",
            "MINIMAX_MCP_BASE_PATH": "LOCAL_OUTPUT_DIRECTORY",
            "MINIMAX_API_HOST": "API_HOST",
            "MINIMAX_API_RESOURCE_MODE": "OPTIONAL_RESOURCE_MODE"
          }
        }
      }
    }
    ```

    *   Replace the placeholder values with your actual values. See the Environment Variables section below for details.
    *   If you're using Windows, enable "Developer Mode" in Claude Desktop by clicking "Help" in the hamburger menu and selecting "Enable Developer Mode".

#### Cursor

1.  Go to `Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server`.
2.  Add the same configuration as described for Claude Desktop (within the `mcpServers` section).

### Environment Variables

The following environment variables are required within the MCP server configuration:

*   `MINIMAX_API_KEY`: Your MiniMax API key.  **Important:** This key must match the API host region.
*   `MINIMAX_MCP_BASE_PATH`: The local directory where output files (audio, images, videos) will be stored.  Example: `/User/xxx/Desktop`.
*   `MINIMAX_API_HOST`: The MiniMax API host URL. Choose the correct host based on your region:
    *   Global: `https://api.minimax.io`
    *   Mainland: `https://api.minimaxi.com`
*   `MINIMAX_API_RESOURCE_MODE` (Optional): Determines how audio/image/video resources are handled.
    *   `url` (default): Resources are provided in URL format.
    *   `local`: Resources are downloaded locally.

**Important Notes:**

*   **API Key and Host Alignment:** Ensure your `MINIMAX_API_KEY` and `MINIMAX_API_HOST` are from the same region (Global or Mainland).  Mismatched keys and hosts will result in an "Invalid API key" error.
*   **`uvx` Path:** If you encounter a "spawn uvx ENOENT" error, determine the absolute path to `uvx` using the command `which uvx` in your terminal.  Update the `"command"` value in your configuration with this absolute path (e.g., `"command": "/usr/local/bin/uvx"`).

## Tools

## Available Tools

| Tool                     | Description