{"type":"mcp_server","name":"MiniMax-MCP","description":"MiniMax MCP server: Enables TTS, image & video generation API access. Facilitates model interaction.","category":"Communication","language":"Python","stars":1521,"forks":121,"owner":"MiniMax-AI","github_url":"https://github.com/MiniMax-AI/MiniMax-MCP","homepage":"https://www.minimax.io/platform","setup":"## Setup\n\nThis guide outlines the steps to set up the MiniMax Model Context Protocol (MCP) server for use with MCP clients like Claude Desktop and Cursor.\n\n### Prerequisites\n\n*   **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.\n*   **Python Package Manager (uv):** Install `uv` using the following command:\n\n    ```bash\n    curl -LsSf https://astral.sh/uv/install.sh | sh\n    ```\n\n    Refer to the [uv repository](https://github.com/astral-sh/uv) for alternative installation methods.\n\n### Installation\n\nThe `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.\n\n### Configuration\n\nThe configuration process varies depending on the MCP client you are using.  Below are instructions for Claude Desktop and Cursor.\n\n#### Claude Desktop\n\n1.  Navigate to `Claude > Settings > Developer > Edit Config > claude_desktop_config.json`.\n2.  Add the following configuration within the `mcpServers` section:\n\n    ```json\n    {\n      \"mcpServers\": {\n        \"MiniMax\": {\n          \"command\": \"uvx\",\n          \"args\": [\n            \"minimax-mcp\",\n            \"-y\"\n          ],\n          \"env\": {\n            \"MINIMAX_API_KEY\": \"YOUR_API_KEY\",\n            \"MINIMAX_MCP_BASE_PATH\": \"LOCAL_OUTPUT_DIRECTORY\",\n            \"MINIMAX_API_HOST\": \"API_HOST\",\n            \"MINIMAX_API_RESOURCE_MODE\": \"OPTIONAL_RESOURCE_MODE\"\n          }\n        }\n      }\n    }\n    ```\n\n    *   Replace the placeholder values with your actual values. See the Environment Variables section below for details.\n    *   If you're using Windows, enable \"Developer Mode\" in Claude Desktop by clicking \"Help\" in the hamburger menu and selecting \"Enable Developer Mode\".\n\n#### Cursor\n\n1.  Go to `Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server`.\n2.  Add the same configuration as described for Claude Desktop (within the `mcpServers` section).\n\n### Environment Variables\n\nThe following environment variables are required within the MCP server configuration:\n\n*   `MINIMAX_API_KEY`: Your MiniMax API key.  **Important:** This key must match the API host region.\n*   `MINIMAX_MCP_BASE_PATH`: The local directory where output files (audio, images, videos) will be stored.  Example: `/User/xxx/Desktop`.\n*   `MINIMAX_API_HOST`: The MiniMax API host URL. Choose the correct host based on your region:\n    *   Global: `https://api.minimax.io`\n    *   Mainland: `https://api.minimaxi.com`\n*   `MINIMAX_API_RESOURCE_MODE` (Optional): Determines how audio/image/video resources are handled.\n    *   `url` (default): Resources are provided in URL format.\n    *   `local`: Resources are downloaded locally.\n\n**Important Notes:**\n\n*   **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.\n*   **`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\n\n| Tool                     | Description","faq":null,"created_at":"2025-04-10T06:15:56+00:00","updated_at":"2025-07-07T13:25:31+00:00","source_url":"https://model-context-protocol.com/servers/minimax-mcp","related_articles":[]}