repository·main·Indexed 23 days ago
https://github.com/minimax-ai/minimax-mcpAn MCP server (version 0.0.18) that enables AI clients like Claude Desktop and Cursor to interact with MiniMax generative APIs. It provides tools for text-to-speech, voice cloning, video generation, and image creation. The server supports both stdio and SSE transport mechanisms and includes a CLI for automatic configuration generation.
The MiniMax MCP server supports two transport methods:
stdout. Supports processing local files or valid URL resources as input.The server supports two transport mechanisms:
stdout. Supports processing local files or valid URL resources.network. When deployed in the cloud, it is recommended to use URL for input.To use the MiniMax MCP server, follow these steps:
uv: Install the Python package manager uv using:curl -LsSf https://astral.sh/uv/install.sh | shMINIMAX_API_KEY and MINIMAX_API_HOST match your region to avoid invalid api key errors.| Region | API Key Source | MINIMAX_API_HOST |
|---|---|---|
| International | MiniMax International | https://api.minimax.io |
| Domestic | MiniMax Domestic | https://api.minimaxi.com |
curl -LsSf https://astral.sh/uv/install.sh | shTo integrate MiniMax with Claude Desktop, edit your claude_desktop_config.json file (located via Claude > Settings > Developer > Edit Config).
Windows Users: You must enable "Developer Mode" in Claude Desktop (via Help > Enable Developer Mode) to use MCP servers.
Configuration Schema:
MINIMAX_API_KEY: Your API key.MINIMAX_MCP_BASE_PATH: Local directory path for output (e.g., /Users/xxx/Desktop).MINIMAX_API_HOST: Must match your key region (https://api.minimaxi.com or https://api.minimax.io).MINIMAX_API_RESOURCE_MODE: (Optional) How resources are provided after generation. Options: url (default) or local.{
"mcpServers": {
"MiniMax": {
"command": "uvx",
"args": [
"minimax-mcp"
],
"env": {
"MINIMAX_API_KEY": "填写你的API密钥",
"MINIMAX_MCP_BASE_PATH": "本地输出目录路径，如/User/xxx/Desktop",
"MINIMAX_API_HOST": "填写API Host, https://api.minimaxi.com 或 https://api.minimax.io",
"MINIMAX_API_RESOURCE_MODE": "可选配置，资源生成后的提供方式, 可选项为 [url|local], 默认为 url"
}
}
}
}Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server and use the same configuration structure used for Claude Desktop.To integrate MiniMax with Claude Desktop, edit your claude_desktop_config.json file (found via Claude > Settings > Developer > Edit Config).
Windows Users: You must enable "Developer Mode" in Claude Desktop by clicking "Help" in the top-left hamburger menu and selecting "Enable Developer Mode".
Troubleshooting spawn uvx ENOENT: If you encounter this error, find the absolute path of uvx by running which uvx in your terminal, and use that full path in the command field of your config.
{
"mcpServers": {
"MiniMax": {
"command": "uvx",
"args": [
"minimax-mcp",
"-y"
],
"env": {
"MINIMAX_API_KEY": "insert-your-api-key-here",
"MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
"MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
"MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
}
}
}
}generate_video tool, you can operate in async-mode. This is useful for long-running video generation tasks where you do not want to block the client execution while waiting for the final result.Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server and use the configuration object provided in the Claude Desktop setup guide.The minimax-mcp CLI can automatically generate the required claude_desktop_config.json for Claude Desktop integration. It detects your platform (Windows, macOS, or Linux) to find the standard Claude configuration directory.
To use this, you must provide a Minimax API key via the --api-key flag or by setting the MINIMAX_API_KEY environment variable.
spawn uvx ENOENT error typically indicates that the uvx command is not found in your system's PATH. This occurs when the MCP client attempts to run the server using uvx but cannot locate the executable. Ensure that uv is installed on your system and accessible via your terminal.invalid api keyEnsure your MINIMAX_API_KEY and MINIMAX_API_HOST belong to the same region:
https://api.minimax.io.https://api.minimaxi.com.spawn uvx ENOENTThis error occurs if the system cannot find the uvx command. Find the absolute path of uvx by running:
which uvxThen, update your MCP configuration command field with the full path (e.g., /usr/local/bin/uvx).
which uvx