minimax-mcp 0.0.2

Minimax MCP Server

Official Minimax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech and audio processing APIs. This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents and others to generate speech, clone voices, transcribe audio, and more.

Quickstart with Claude Desktop

1. Get your API key from Minimax.
2. Install uv (Python package manager), install with curl -LsSf https://astral.sh/uv/install.sh | sh or see the uv repo for additional install methods.
3. Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:

{
  "mcpServers": {
    "Minimax": {
      "command": "/Users/minimax/py/minimax-mcp/.venv/bin/python", # 需要按本地环境进行配置
      "args": [
        "/Users/minimax/py/minimax-mcp/minimax_mcp/server.py" # 需要按本地环境进行配置
      ],
      "env": {
        "MINIMAX_API_KEY": "<insert-your-api-key-here>",
        "MINIMAX_MCP_BASE_PATH": "<local-output-dir-path>",
        "MINIMAX_API_HOST": "https://api.minimax.chat"
      }
    }
  }
}

If you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu in the top left and select "Enable Developer Mode".

Other MCP clients

For other clients like Cursor and Windsurf, run:

1. pip install minimax-mcp // 尚未上传到 pypi 仓库
2. python -m minimax_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print to get the configuration. Paste it into appropriate configuration directory specified by your MCP client.

That's it. Your MCP client can now interact with Minimax through these tools:

Example usage

⚠️ Warning: Minimax credits are needed to use these tools.

Try asking Claude:

todo

Optional features

You can add the MINIMAX_MCP_BASE_PATH environment variable to the claude_desktop_config.json to specify the base path MCP server should look for and output files specified with relative paths.

Contributing

Troubleshooting

Logs when running with Claude Desktop can be found at:

• Windows: %APPDATA%\Claude\logs\mcp-server-minimax.log
• macOS: ~/Library/Logs/Claude/mcp-server-minimax.log

Timeouts when using certain tools

Certain Minimax API operations like voice design and audio isolation can take a long time to resolve. When using the MCP inspector in dev mode you might get timeout errors, despite the tool completing its intended task.

This shouldn't occur when using a client like Claude.