首页
学习
活动
专区
圈层
工具
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往
首页
学习
活动
专区
圈层
工具
MCP广场
MCP广场 >详情页
MiniMax-MCP云托管模式2025-05-227分享
github
MiniMax官方模型上下文协议(MCP)服务器,支持与强大的文本转语音和视频/图像生成API交互。允许MCP客户端如Claude Desktop、Cursor、Windsurf、OpenAI Agents等生成语音、克隆声音、生成视频、生成图像等功能。
By MiniMax-AI
2025-05-227
github
详情内容

export

English Version

MiniMax官方模型上下文协议(MCP)服务器,支持与强大的文本转语音和视频/图像生成API交互。允许MCP客户端如Claude DesktopCursorWindsurfOpenAI Agents等生成语音、克隆声音、生成视频、生成图像等功能。

Documentation

快速开始使用 MCP 客户端

  1. MiniMax国内开放平台MiniMax国际开放平台获取你的 API 密钥。
  2. 安装uv(Python包管理器),使用curl -LsSf https://astral.sh/uv/install.sh | sh安装或查看uv 仓库获取其他安装方法。
  3. 重要提示: API的服务器地址和密钥在不同区域有所不同,两者需要匹配,否则会有 invalid api key 的错误
地区 国际 国内
MINIMAX_API_KEY 获取密钥 MiniMax国际版 获取密钥 MiniMax
MINIMAX_API_HOST ​https://api.minimaxi.chat (请注意额外的 "i" 字母) ​https://api.minimax.chat

Claude Desktop

前往Claude > Settings > Developer > Edit Config > claude_desktop_config.json包含以下内容:

{
  "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.minimax.chat 或 https://api.minimaxi.chat",
        "MINIMAX_API_RESOURCE_MODE": "可选配置,资源生成后的提供方式, 可选项为 [url|local], 默认为 url"
      }
    }
  }
}

⚠️ 注意:API Key需要与Host匹配。如果出现“API Error: invalid api key”错误,请检查您的API Host:

  • 国际版Host:https://api.minimaxi.chat(请注意额外的 "i" 字母)
  • 国内版Host:https://api.minimax.chat

如果你使用Windows,你需要在Claude Desktop中启用"开发者模式"才能使用MCP服务器。点击左上角汉堡菜单中的"Help",然后选择"Enable Developer Mode"。

Cursor

前往Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server添加上述配置。

你的MCP客户端现在可以通过Claude Desktop和Cursor等这些工具与MiniMax交互:

Transport

我们支持两种传输方式: stdio and sse.

stdio SSE
在本地部署运行 本地或云端部署均可
通过 stdout 进行通信 通过网络通信
输入:支持处理本地文件,或有效的URL资源 输入: 若部署在云端,建议使用URL进行输入

可用方法

方法 描述
text_to_audio 使用指定音色将文本生成音频
list_voices 查询所有可用音色
voice_clone 根据指定音频文件克隆音色
generate_video 根据指定 prompt 生成视频
text_to_image 根据指定 prompt 生成图片

FAQ

1. invalid api key

请检查你获取的 API Key 和填写的 API Host 是否是同一地区的:

地区 国际 国内
MINIMAX_API_KEY 获取密钥 MiniMax国际版 获取密钥 MiniMax
MINIMAX_API_HOST ​https://api.minimaxi.chat (请注意额外的 "i" 字母) ​https://api.minimax.chat

2. spawn uvx ENOENT

请在你的终端输入一下命令,查看uvx命令的绝对路径:

which uvx

如果得到如下的输出 (如:/usr/local/bin/uvx),更新mcp配置 ("command": "/usr/local/bin/uvx").

使用示例

⚠️ 注意:使用这些工具可能会产生费用。

1. 播报晚间新闻片段

2. 克隆声音

3. 生成视频

4. 生成图像

通过SSE URL连接服务
Server已在腾讯云托管,可在连接后免费调用和在线进行工具测试~
工具测试
已支持Server下的6个工具,可选择工具进行在线测试
text_to_audio
Convert text to audio with a given voice and save the output audio file to a given directory. Directory is optional, if not provided, the output file will be saved to $HOME/Desktop. Voice id is optional, if not provided, the default voice will be used. COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user. Args: text (str): The text to convert to speech. voice_id (str, optional): The id of the voice to use. For example, "male-qn-qingse"/"audiobook_female_1"/"cute_boy"/"Charming_Lady"... model (string, optional): The model to use. speed (float, optional): Speed of the generated audio. Controls the speed of the generated speech. Values range from 0.5 to 2.0, with 1.0 being the default speed. vol (float, optional): Volume of the generated audio. Controls the volume of the generated speech. Values range from 0 to 10, with 1 being the default volume. pitch (int, optional): Pitch of the generated audio. Controls the speed of the generated speech. Values range from -12 to 12, with 0 being the default speed. emotion (str, optional): Emotion of the generated audio. Controls the emotion of the generated speech. Values range ["happy", "sad", "angry", "fearful", "disgusted", "surprised", "neutral"], with "happy" being the default emotion. sample_rate (int, optional): Sample rate of the generated audio. Controls the sample rate of the generated speech. Values range [8000,16000,22050,24000,32000,44100] with 32000 being the default sample rate. bitrate (int, optional): Bitrate of the generated audio. Controls the bitrate of the generated speech. Values range [32000,64000,128000,256000] with 128000 being the default bitrate. channel (int, optional): Channel of the generated audio. Controls the channel of the generated speech. Values range [1, 2] with 1 being the default channel. format (str, optional): Format of the generated audio. Controls the format of the generated speech. Values range ["pcm", "mp3","flac"] with "mp3" being the default format. language_boost (str, optional): Language boost of the generated audio. Controls the language boost of the generated speech. Values range ['Chinese', 'Chinese,Yue', 'English', 'Arabic', 'Russian', 'Spanish', 'French', 'Portuguese', 'German', 'Turkish', 'Dutch', 'Ukrainian', 'Vietnamese', 'Indonesian', 'Japanese', 'Italian', 'Korean', 'Thai', 'Polish', 'Romanian', 'Greek', 'Czech', 'Finnish', 'Hindi', 'auto'] with "auto" being the default language boost. Returns: Text content with the path to the output file and name of the voice used.
list_voices
List all voices available. Only supports when api_host is https://api.minimax.chat Args: voice_type (str, optional): The type of voices to list. Values range ["all", "system", "voice_cloning"], with "all" being the default. Returns: Text content with the list of voices.
voice_clone
Clone a voice using provided audio files. The new voice will be charged upon first use. COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user. Args: voice_id (str): The id of the voice to use. file (str): The path to the audio file to clone or a URL to the audio file. text (str, optional): The text to use for the demo audio. is_url (bool, optional): Whether the file is a URL. Defaults to False. Returns: Text content with the voice id of the cloned voice.
play_audio
Play an audio file. Supports WAV and MP3 formats. Not supports video. Args: input_file_path (str): The path to the audio file to play. is_url (bool, optional): Whether the audio file is a URL. Returns: Text content with the path to the audio file.
generate_video
Generate a video from a prompt. COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user. Args: model (str, optional): The model to use. Values range ["T2V-01", "T2V-01-Director", "I2V-01", "I2V-01-Director", "I2V-01-live"]. "Director" supports inserting instructions for camera movement control. "I2V" for image to video. "T2V" for text to video. prompt (str): The prompt to generate the video from. When use Director model, the prompt supports 15 Camera Movement Instructions (Enumerated Values) -Truck: [Truck left], [Truck right] -Pan: [Pan left], [Pan right] -Push: [Push in], [Pull out] -Pedestal: [Pedestal up], [Pedestal down] -Tilt: [Tilt up], [Tilt down] -Zoom: [Zoom in], [Zoom out] -Shake: [Shake] -Follow: [Tracking shot] -Static: [Static shot] first_frame_image (str): The first frame image. The model must be "I2V" Series. output_directory (str, optional): The directory to save the video to. Returns: Text content with the path to the output video file.
text_to_image
Generate a image from a prompt. COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user. Args: model (str, optional): The model to use. Values range ["image-01"], with "image-01" being the default. prompt (str): The prompt to generate the image from. aspect_ratio (str, optional): The aspect ratio of the image. Values range ["1:1", "16:9","4:3", "3:2", "2:3", "3:4", "9:16", "21:9"], with "1:1" being the default. n (int, optional): The number of images to generate. Values range [1, 9], with 1 being the default. prompt_optimizer (bool, optional): Whether to optimize the prompt. Values range [True, False], with True being the default. output_directory (str, optional): The directory to save the image to. Returns: Text content with the path to the output image file.
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档