[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-MiniMax-AI--MiniMax-MCP":3,"tool-MiniMax-AI--MiniMax-MCP":62},[4,18,26,35,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,2,"2026-04-10T11:39:34",[14,15,13],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":32,"last_commit_at":41,"category_tags":42,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[43,13,15,14],"插件",{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[52,15,13,14],"语言模型",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,61],"视频",{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":77,"owner_email":78,"owner_twitter":79,"owner_website":80,"owner_url":81,"languages":82,"stars":91,"forks":92,"last_commit_at":93,"license":94,"difficulty_score":32,"env_os":95,"env_gpu":96,"env_ram":96,"env_deps":97,"category_tags":103,"github_topics":105,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":116,"updated_at":117,"faqs":118,"releases":154},6737,"MiniMax-AI\u002FMiniMax-MCP","MiniMax-MCP","Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.","MiniMax-MCP 是 MiniMax 官方推出的模型上下文协议（MCP）服务器，旨在为开发者提供一套标准化的接口，轻松调用 MiniMax 强大的多模态生成能力。通过它，用户可以便捷地接入高质量的文本转语音、图像生成以及视频生成 API，将复杂的模型调用过程简化为统一的协议交互。\n\n这一工具主要解决了不同 AI 服务之间接口标准不一、集成成本高的问题。以往开发者需要针对每种能力编写独立的适配代码，而 MiniMax-MCP 通过遵循通用的 MCP 标准，让各类应用能够像“插拔电源”一样快速连接 MiniMax 的生成模型，大幅降低了开发门槛和维护复杂度。\n\nMiniMax-MCP 特别适合软件开发者、AI 应用构建者以及希望在自己的产品中嵌入多模态功能的技术团队使用。无论是打造智能助手、内容创作平台，还是探索交互式多媒体应用，都能从中获益。其核心亮点在于对 MCP 协议的原生支持，这不仅意味着更流畅的工具链整合，也为未来接入更多 MiniMax 模型预留了灵活扩展的空间，让创新想法能更快地转化为现实应用。","![export](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FMiniMax-AI_MiniMax-MCP_readme_b01673e3edf8.png)\n\n\u003Cdiv align=\"center\" style=\"line-height: 1;\">\n  \u003Ca href=\"https:\u002F\u002Fwww.minimax.io\" target=\"_blank\" style=\"margin: 2px; color: var(--fgColor-default);\">\n    \u003Cimg alt=\"Homepage\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F_Homepage-MiniMax-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM1LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS4wNmE0MC44Miw0MC44MiwwLDAsMS04MS42MywwVjE5NS40MmExMS42MywxMS42MywwLDAsMSwyMy4yNiwwdjI4LjY2YTE3LjU1LDE3LjU1LDAsMCwwLDM1LjEsMFYxNDVBNDAuODIsNDAuODIsMCwwLDEsMTQwLDE0NVYzMzEuNTZhMTcuNTUsMTcuNTUsMCwwLDAsMzUuMSwwVjIxNy41aDBWNDAuODFhNDAuODEsNDAuODEsMCwxLDEsODEuNjIsMFYyODEuNTZhMTEuNjMsMTEuNjMsMCwxLDEtMjMuMjYsMFptMjE1LjksNjMuNEE0MC44Niw0MC44NiwwLDAsMCw0MDguNTMsMTQ1VjMwMC44NWExNy41NSwxNy41NSwwLDAsMS0zNS4wOSwwdi0yNjBhNDAuODIsNDAuODIsMCwwLDAtODEuNjMsMFYzNzAuODlhMTcuNTUsMTcuNTUsMCwwLDEtMzUuMSwwVjMzMGExMS42MywxMS42MywwLDEsMC0yMy4yNiwwdjQwLjg2YTQwLjgxLDQwLjgxLDAsMCwwLDgxLjYyLDBWNDAuODFhMTcuNTUsMTcuNTUsMCwwLDEsMzUuMSwwdjI2MGE0MC44Miw0MC44MiwwLDAsMCw4MS42MywwVjE0NWExNy41NSwxNy41NSwwLDEsMSwzNS4xLDBWMjgxLjU2YTExLjYzLDExLjYzLDAsMCwwLDIzLjI2LDBWMTQ1QTQwLjg1LDQwLjg1LDAsMCwwLDQ0OS4zNSwxMDQuMjFaIi8+PC9zdmc+&logoWidth=20\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Farxiv.org\u002Fabs\u002F2501.08313\" target=\"_blank\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"Paper\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F📖_Paper-MiniMax--01-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n   \u003Ca href=\"https:\u002F\u002Fchat.minimax.io\u002F\" target=\"_blank\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"Chat\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F_MiniMax_Chat-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM1LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS4wNmE0MC44Miw0MC44MiwwLDAsMS04MS42MywwVjE5NS40MmExMS42MywxMS42MywwLDAsMSwyMy4yNiwwdjI4LjY2YTE3LjU1LDE3LjU1LDAsMCwwLDM1LjEsMFYxNDVBNDAuODIsNDAuODIsMCwwLDEsMTQwLDE0NVYzMzEuNTZhMTcuNTUsMTcuNTUsMCwwLDAsMzUuMSwwVjIxNy41aDBWNDAuODFhNDAuODEsNDAuODEsMCwxLDEsODEuNjIsMFYyODEuNTZhMTEuNjMsMTEuNjMsMCwxLDEtMjMuMjYsMFptMjE1LjksNjMuNEE0MC44Niw0MC44NiwwLDAsMCw0MDguNTMsMTQ1VjMwMC44NWExNy41NSwxNy41NSwwLDAsMS0zNS4wOSwwdi0yNjBhNDAuODIsNDAuODIsMCwwLDAtODEuNjMsMFYzNzAuODlhMTcuNTUsMTcuNTUsMCwwLDEtMzUuMSwwVjMzMGExMS42MywxMS42MywwLDEsMC0yMy4yNiwwdjQwLjg2YTQwLjgxLDQwLjgxLDAsMCwwLDgxLjYyLDBWNDAuODFhMTcuNTUsMTcuNTUsMCwwLDEsMzUuMSwwdjI2MGE0MC44Miw0MC44MiwwLDAsMCw4MS42MywwVjE0NWExNy41NSwxNy41NSwwLDEsMSwzNS4xLDBWMjgxLjU2YTExLjYzLDExLjYzLDAsMCwwLDIzLjI2LDBWMTQ1QTQwLjg1LDQwLjg1LDAsMCwwLDQ0OS4zNSwxMDQuMjFaIi8+PC9zdmc+&logoWidth=20\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.minimax.io\u002Fplatform\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"API\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F⚡_API-Platform-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>  \n\u003C\u002Fdiv>\n\u003Cdiv align=\"center\" style=\"line-height: 1;\">\n  \u003Ca href=\"https:\u002F\u002Fhuggingface.co\u002FMiniMaxAI\" target=\"_blank\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"Hugging Face\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F🤗_Hugging_Face-MiniMax-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-AI.github.io\u002Fblob\u002Fmain\u002Fimages\u002Fwechat-qrcode.jpeg\" target=\"_blank\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"WeChat\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F_WeChat-MiniMax-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.modelscope.cn\u002Forganization\u002FMiniMax\" target=\"_blank\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"ModelScope\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F_ModelScope-MiniMax-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n\u003C\u002Fdiv>\n\u003Cdiv align=\"center\" style=\"line-height: 1;\">\n   \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP\u002Fblob\u002Fmain\u002FLICENSE\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"Code License\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F_Code_License-MIT-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n\u003C\u002Fdiv>\n\n\u003Cp align=\"center\">\n  Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech and video\u002Fimage generation APIs. This server allows MCP clients like \u003Ca href=\"https:\u002F\u002Fwww.anthropic.com\u002Fclaude\">Claude Desktop\u003C\u002Fa>, \u003Ca href=\"https:\u002F\u002Fwww.cursor.so\">Cursor\u003C\u002Fa>, \u003Ca href=\"https:\u002F\u002Fcodeium.com\u002Fwindsurf\">Windsurf\u003C\u002Fa>, \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fopenai-agents-python\">OpenAI Agents\u003C\u002Fa> and others to generate speech, clone voices, generate video, generate image and more.\n\u003C\u002Fp>\n\n## Documentation\n- [中文文档](README-CN.md)\n- [MiniMax-MCP-JS](https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP-JS) - Official JavaScript implementation of MiniMax MCP\n\n## Quickstart with MCP Client\n1. Get your API key from [MiniMax](https:\u002F\u002Fwww.minimax.io\u002Fplatform\u002Fuser-center\u002Fbasic-information\u002Finterface-key). \n2. Install `uv` (Python package manager), install with `curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh` or see the `uv` [repo](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv) for additional install methods.\n3. **Important**: The API host and key vary by region and must match; otherwise, you'll encounter an `Invalid API key` error.\n\n|Region| Global  | Mainland  |\n|:--|:-----|:-----|\n|MINIMAX_API_KEY| go get from [MiniMax Global](https:\u002F\u002Fwww.minimax.io\u002Fplatform\u002Fuser-center\u002Fbasic-information\u002Finterface-key) | go get from [MiniMax](https:\u002F\u002Fplatform.minimaxi.com\u002Fuser-center\u002Fbasic-information\u002Finterface-key) |\n|MINIMAX_API_HOST| https:\u002F\u002Fapi.minimax.io | https:\u002F\u002Fapi.minimaxi.com |\n\n\n### Claude Desktop\nGo to `Claude > Settings > Developer > Edit Config > claude_desktop_config.json` to include the following:\n\n```\n{\n  \"mcpServers\": {\n    \"MiniMax\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"minimax-mcp\",\n        \"-y\"\n      ],\n      \"env\": {\n        \"MINIMAX_API_KEY\": \"insert-your-api-key-here\",\n        \"MINIMAX_MCP_BASE_PATH\": \"local-output-dir-path, such as \u002FUser\u002Fxxx\u002FDesktop\",\n        \"MINIMAX_API_HOST\": \"api host, https:\u002F\u002Fapi.minimax.io | https:\u002F\u002Fapi.minimaxi.com\",\n        \"MINIMAX_API_RESOURCE_MODE\": \"optional, [url|local], url is default, audio\u002Fimage\u002Fvideo are downloaded locally or provided in URL format\"\n      }\n    }\n  }\n}\n\n```\n⚠️ Warning: The API key needs to match the host. If an error \"API Error: invalid api key\" occurs, please check your api host:\n- Global Host：`https:\u002F\u002Fapi.minimax.io`\n- Mainland Host：`https:\u002F\u002Fapi.minimaxi.com`\n\nIf 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\".\n\n\n### Cursor\nGo to `Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server` to add above config.\n\nThat's it. Your MCP client can now interact with MiniMax through these tools:\n\n## Transport\nWe support two transport types: stdio and sse.\n| stdio  | SSE  |\n|:-----|:-----|\n| Run locally | Can be deployed locally or in the cloud |\n| Communication through `stdout` | Communication through `network` |\n| Input: Supports processing `local files` or valid `URL` resources | Input: When deployed in the cloud, it is recommended to use `URL` for input |\n\n## Available Tools\n| tool  | description  |\n|-|-|\n|`text_to_audio`|Convert text to audio with a given voice|\n|`list_voices`|List all voices available|\n|`voice_clone`|Clone a voice using provided audio files|\n|`generate_video`|Generate a video from a prompt|\n|`text_to_image`|Generate a image from a prompt|\n|`query_video_generation`|Query the result of video generation task|\n|`music_generation`|Generate a music track from a prompt and lyrics|\n|`voice_design`|Generate a voice from a prompt using preview text|\n\n## Release Notes\n\n### July 2, 2025\n\n#### 🆕 What's New\n- **Voice Design**: New `voice_design` tool - create custom voices from descriptive prompts with preview audio\n- **Video Enhancement**: Added `MiniMax-Hailuo-02` model with ultra-clear quality and duration\u002Fresolution controls  \n- **Music Generation**: Enhanced `music_generation` tool powered by `music-1.5` model\n\n#### 📈 Enhanced Tools\n- `voice_design` - Generate personalized voices from text descriptions\n- `generate_video` - Now supports MiniMax-Hailuo-02 with 6s\u002F10s duration and 768P\u002F1080P resolution options\n- `music_generation` - High-quality music creation with music-1.5 model\n\n## FAQ\n### 1. invalid api key\nPlease ensure your API key and API host are regionally aligned\n|Region| Global  | Mainland  |\n|:--|:-----|:-----|\n|MINIMAX_API_KEY| go get from [MiniMax Global](https:\u002F\u002Fwww.minimax.io\u002Fplatform\u002Fuser-center\u002Fbasic-information\u002Finterface-key) | go get from [MiniMax](https:\u002F\u002Fplatform.minimaxi.com\u002Fuser-center\u002Fbasic-information\u002Finterface-key) |\n|MINIMAX_API_HOST| https:\u002F\u002Fapi.minimax.io | https:\u002F\u002Fapi.minimaxi.com |\n\n### 2. spawn uvx ENOENT\nPlease confirm its absolute path by running this command in your terminal:\n```sh\nwhich uvx\n```\nOnce you obtain the absolute path (e.g., \u002Fusr\u002Flocal\u002Fbin\u002Fuvx), update your configuration to use that path (e.g., \"command\": \"\u002Fusr\u002Flocal\u002Fbin\u002Fuvx\"). \n\n### 3. How to use `generate_video` in async-mode\nDefine completion rules before starting:\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002Fcursor_rule2.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\nAlternatively, these rules can be configured in your IDE settings (e.g., Cursor):\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002Fcursor_video_rule.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n\n\n## Example usage\n\n⚠️ Warning: Using these tools may incur costs.\n\n### 1. broadcast a segment of the evening news\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002FSnipaste_2025-04-09_20-07-53.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n\n### 2. clone a voice\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002FSnipaste_2025-04-09_19-45-13.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n\n### 3. generate a video\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002FSnipaste_2025-04-09_19-58-52.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002FSnipaste_2025-04-09_19-59-43.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle; \"\u002F>\n\n### 4. generate images\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002Fgen_image.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002Fgen_image1.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle; \"\u002F>\n","![export](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FMiniMax-AI_MiniMax-MCP_readme_b01673e3edf8.png)\n\n\u003Cdiv align=\"center\" style=\"line-height: 1;\">\n  \u003Ca href=\"https:\u002F\u002Fwww.minimax.io\" target=\"_blank\" style=\"margin: 2px; color: var(--fgColor-default);\">\n    \u003Cimg alt=\"首页\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F_首页-MiniMax-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM1LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS4wNmE0MC44Miw0MC44MiwwLDAsMS04MS42MywwVjE5NS40MmExMS42MywxMS42MywwLDAsMSwyMy4yNiwwdjI4LjY2YTE3LjU1LDE3LjU1LDAsMCwwLDM1LjEsMFYxNDVBNDAuODIsNDAuODIsMCwwLDEsMTQwLDE0NVYzMzEuNTZhMTcuNTUsMTcuNTUsMCwwLDAsMzUuMSwwVjIxNy.5aDBWNDAuODFhNDAuODEsNDAuODEsMCwxLDEsODEuNjIsMFYyADEuNTZhMTEuNjMsMTEuNjMsMCwxLDEtMjMuMjYsMFptMjE1LjksNjMuNEE0MC44Niw0MC44NiwwLDAsMCw0MDguNTMsMTQ1VjMwMC.45NWExNy.5NSwxNy.5NSwwLDAsMS0zNS.5Ogswwdi-260A40.42s40.42sMCwwLDAtODEuNjMsMFYzN70.89gMTuNTUsMTuNTUsMCwwLDEtMzUuMSwwVjMzMGExMS.63s40.63sMCwwLDAsMC0yMy.63swwdj40.86YT40.81s40.81sLDAsMCwwLDgx.62sDFDAuODFhMTuNTUsMTuNTUsMCwwLDEsMzUuMSwwdj260A40.42s40.42sMCwwLDAtODEuNjMsMFYxNDVExNy.5NSwxNy.5NSwwLDAsMSwzNS.5LDBWMjADEuNT6YTMTuNTUsMTuNTUsLDAsMCwwLDIz.26sDFDAuODFQT40.85s40.85sLDAsMCwwLDQ49.35s104.25sIi8+PC9zdmc+&logoWidth=20\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Farxiv.org\u002Fabs\u002F2501.08313\" target=\"_blank\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"论文\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F📖_论文-MiniMax--01-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n   \u003Ca href=\"https:\u002F\u002Fchat.minimax.io\u002F\" target=\"_blank\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"聊天\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F_MiniMax_聊天-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM5LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS.06E40.42s40.42sMCwwLDAsMS081.63sDFDAuODFVjE95.42sExMT.63s40.63sLDAsMCwwLDIz.26sDFDAuODFVjxNDVExNy.5NSwxNy.5NSwwLDAsMSwzNS.5LDBWMjADEuNT6YTMT.63sLDAsMCwwLDIz.26sDFDAuODFQT40.85s40.85sLDAsMCwwLDQ49.35s104.25sIi8+PC9zdmc+&logoWidth=20\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.minimax.io\u002Fplatform\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"API\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F⚡_API-平台-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>  \n\u003C\u002Fdiv>\n\u003Cdiv align=\"center\" style=\"line-height: 1;\">\n  \u003Ca href=\"https:\u002F\u002Fhuggingface.co\u002FMiniMaxAI\" target=\"_blank\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"Hugging Face\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F🤗_Hugging_Face-MiniMax-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-AI.github.io\u002Fblob\u002Fmain\u002Fimages\u002Fwechat-qrcode.jpeg\" target=\"_blank\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"微信\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F_微信-MiniMax-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.modelscope.cn\u002Forganization\u002FMiniMax\" target=\"_blank\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"ModelScope\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F_ModelScope-MiniMax-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n\u003C\u002Fdiv>\n\u003Cdiv align=\"center\" style=\"line-height: 1;\">\n   \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP\u002Fblob\u002Fmain\u002FLICENSE\" style=\"margin: 2px;\">\n    \u003Cimg alt=\"代码许可\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F_代码_许可-MIT-FF4040?style=flat-square&labelColor=2C3E50\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n  \u003C\u002Fa>\n\u003C\u002Fdiv>\n\n\u003Cp align=\"center\">\n  官方 MiniMax 模型上下文协议（MCP）服务器，支持与强大的文本转语音以及视频\u002F图像生成 API 进行交互。该服务器允许 MCP 客户端，如 \u003Ca href=\"https:\u002F\u002Fwww.anthropic.com\u002Fclaude\">Claude Desktop\u003C\u002Fa>、\u003Ca href=\"https:\u002F\u002Fwww.cursor.so\">Cursor\u003C\u002Fa>、\u003Ca href=\"https:\u002F\u002Fcodeium.com\u002Fwindsurf\">Windsurf\u003C\u002Fa>、\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fopenai-agents-python\">OpenAI Agents\u003C\u002Fa> 等，进行语音生成、声音克隆、视频生成、图像生成等操作。\n\u003C\u002Fp>\n\n## 文档\n- [中文文档](README-CN.md)\n- [MiniMax-MCP-JS](https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP-JS) - MiniMax MCP 的官方 JavaScript 实现\n\n## 使用 MCP 客户端快速入门\n1. 从 [MiniMax](https:\u002F\u002Fwww.minimax.io\u002Fplatform\u002Fuser-center\u002Fbasic-information\u002Finterface-key) 获取您的 API 密钥。\n2. 安装 `uv`（Python 包管理器），可通过 `curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh` 命令安装，或参阅 `uv` 的 [仓库](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv) 以获取其他安装方法。\n3. **重要提示**：API 主机和密钥因地区而异，必须匹配；否则，您将收到“无效的 API 密钥”错误。\n\n|地区| 全球  | 中国大陆  |\n|:--|:-----|:-----|\n|MINIMAX_API_KEY| 从 [MiniMax 全球](https:\u002F\u002Fwww.minimax.io\u002Fplatform\u002Fuser-center\u002Fbasic-information\u002Finterface-key) 获取 | 从 [MiniMax](https:\u002F\u002Fplatform.minimaxi.com\u002Fuser-center\u002Fbasic-information\u002Finterface-key) 获取 |\n|MINIMAX_API_HOST| https:\u002F\u002Fapi.minimax.io | https:\u002F\u002Fapi.minimaxi.com |\n\n### Claude Desktop\n前往 `Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json`，添加以下内容：\n\n```\n{\n  \"mcpServers\": {\n    \"MiniMax\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"minimax-mcp\",\n        \"-y\"\n      ],\n      \"env\": {\n        \"MINIMAX_API_KEY\": \"在此处插入您的API密钥\",\n        \"MINIMAX_MCP_BASE_PATH\": \"本地输出目录路径，例如 \u002FUser\u002Fxxx\u002FDesktop\",\n        \"MINIMAX_API_HOST\": \"API主机地址，https:\u002F\u002Fapi.minimax.io 或 https:\u002F\u002Fapi.minimaxi.com\",\n        \"MINIMAX_API_RESOURCE_MODE\": \"可选，[url|local]，默认为url，音频\u002F图片\u002F视频可以下载到本地或以URL形式提供\"\n      }\n    }\n  }\n}\n\n```\n⚠️ 注意：API密钥必须与主机匹配。如果出现“API错误：无效的API密钥”提示，请检查您的API主机：\n- 全球主机：`https:\u002F\u002Fapi.minimax.io`\n- 中国大陆主机：`https:\u002F\u002Fapi.minimaxi.com`\n\n如果您使用的是Windows系统，需要在Claude Desktop中启用“开发者模式”才能使用MCP服务器。请单击左上角汉堡菜单中的“帮助”，然后选择“启用开发者模式”。\n\n\n### Cursor\n前往 `Cursor -> 首选项 -> Cursor设置 -> MCP -> 添加新的全局MCP服务器`，添加上述配置。\n\n完成以上步骤后，您的MCP客户端即可通过这些工具与MiniMax进行交互：\n\n## 传输方式\n我们支持两种传输方式：stdio 和 sse。\n| stdio  | SSE  |\n|:-----|:-----|\n| 在本地运行 | 可以部署在本地或云端 |\n| 通过 `stdout` 进行通信 | 通过 `网络` 进行通信 |\n| 输入：支持处理 `本地文件` 或有效的 `URL` 资源 | 输入：在云端部署时，建议使用 `URL` 作为输入 |\n\n## 可用工具\n| 工具  | 描述  |\n|-|-|\n|`text_to_audio`|将文本转换为指定语音的音频|\n|`list_voices`|列出所有可用的语音|\n|`voice_clone`|使用提供的音频文件克隆语音|\n|`generate_video`|根据提示生成视频|\n|`text_to_image`|根据提示生成图像|\n|`query_video_generation`|查询视频生成任务的结果|\n|`music_generation`|根据提示和歌词生成音乐曲目|\n|`voice_design`|使用预览文本根据提示生成语音|\n\n## 发布说明\n\n### 2025年7月2日\n\n#### 🆕 新功能\n- **Voice Design**：新增 `voice_design` 工具——通过描述性提示和预览音频创建自定义语音\n- **视频增强**：新增 `MiniMax-Hailuo-02` 模型，具有超清晰画质，并可控制时长和分辨率  \n- **音乐生成**：由 `music-1.5` 模型驱动的 `music_generation` 工具得到增强\n\n#### 📈 功能提升\n- `voice_design`——根据文本描述生成个性化语音\n- `generate_video`——现支持 MiniMax-Hailuo-02 模型，提供6秒\u002F10秒时长及768P\u002F1080P分辨率选项\n- `music_generation`——基于 music-1.5 模型实现高质量音乐创作\n\n## 常见问题解答\n### 1. API密钥无效\n请确保您的API密钥和API主机在地域上一致：\n|地区| 全球  | 中国大陆  |\n|:--|:-----|:-----|\n|MINIMAX_API_KEY| 从 [MiniMax Global](https:\u002F\u002Fwww.minimax.io\u002Fplatform\u002Fuser-center\u002Fbasic-information\u002Finterface-key) 获取 | 从 [MiniMax](https:\u002F\u002Fplatform.minimaxi.com\u002Fuser-center\u002Fbasic-information\u002Finterface-key) 获取 |\n|MINIMAX_API_HOST| https:\u002F\u002Fapi.minimax.io | https:\u002F\u002Fapi.minimaxi.com |\n\n### 2. spawn uvx ENOENT\n请通过在终端中运行以下命令确认其绝对路径：\n```sh\nwhich uvx\n```\n获取绝对路径后（例如 \u002Fusr\u002Flocal\u002Fbin\u002Fuvx），请更新您的配置以使用该路径（例如 `\"command\": \"\u002Fusr\u002Flocal\u002Fbin\u002Fuvx\"`）。\n\n### 3. 如何以异步模式使用 `generate_video`\n在开始之前定义完成规则：\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002Fcursor_rule2.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n或者，您也可以在IDE设置中配置这些规则（例如 Cursor）：\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002Fcursor_video_rule.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n\n\n## 使用示例\n\n⚠️ 注意：使用这些工具可能会产生费用。\n\n### 1. 播报一段晚间新闻\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002FSnipaste_2025-04-09_20-07-53.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n\n### 2. 克隆一种语音\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002FSnipaste_2025-04-09_19-45-13.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n\n### 3. 生成一段视频\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002FSnipaste_2025-04-09_19-58-52.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002FSnipaste_2025-04-09_19-59-43.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle; \"\u002F>\n\n### 4. 生成图像\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002Fgen_image.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle;\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Fpublic-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com\u002Fgen_image1.png?x-oss-process=image\u002Fresize,p_50\u002Fformat,webp\" style=\"display: inline-block; vertical-align: middle; \"\u002F>","# MiniMax-MCP 快速上手指南\n\nMiniMax-MCP 是官方的模型上下文协议（MCP）服务器，允许 Claude Desktop、Cursor、Windsurf 等客户端调用 MiniMax 强大的语音合成、声音克隆、视频生成及图像生成能力。\n\n## 环境准备\n\n在开始之前，请确保满足以下要求：\n\n1.  **API 密钥**：拥有有效的 MiniMax API Key。\n    *   **中国大陆用户**：请访问 [MiniMax 开放平台](https:\u002F\u002Fplatform.minimaxi.com\u002Fuser-center\u002Fbasic-information\u002Finterface-key) 获取密钥。\n    *   **海外用户**：请访问 [MiniMax Global](https:\u002F\u002Fwww.minimax.io\u002Fplatform\u002Fuser-center\u002Fbasic-information\u002Finterface-key) 获取密钥。\n2.  **Python 包管理器 `uv`**：本项目依赖 `uv` 运行。\n    *   安装命令（Linux\u002FmacOS）：\n        ```bash\n        curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n        ```\n    *   Windows 用户请参考 [uv 官方仓库](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv) 进行安装。\n3.  **支持的 MCP 客户端**：已安装 Claude Desktop、Cursor 或 Windsurf 等支持 MCP 协议的编辑器\u002F应用。\n\n> **⚠️ 重要提示**：API Key 必须与 API 主机地址（Host）区域对应，否则会报错 `Invalid API key`。\n> *   **中国大陆**：Key 来自 `platform.minimaxi.com`，Host 设为 `https:\u002F\u002Fapi.minimaxi.com`\n> *   **全球其他地区**：Key 来自 `www.minimax.io`，Host 设为 `https:\u002F\u002Fapi.minimax.io`\n\n## 安装与配置\n\n根据你使用的客户端，选择以下一种方式进行配置。\n\n### 方式一：Claude Desktop 配置\n\n1.  打开配置文件：`Claude` > `Settings` > `Developer` > `Edit Config`，编辑 `claude_desktop_config.json`。\n    *   *Windows 用户注意*：需先在左上角菜单 `Help` 中启用 \"Enable Developer Mode\"。\n2.  将以下配置填入 JSON 文件中（注意替换占位符）：\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\": \"在此处填入你的 API Key\",\n        \"MINIMAX_MCP_BASE_PATH\": \"本地输出目录路径，例如 C:\u002FUsers\u002Fxxx\u002FDesktop 或 \u002FUsers\u002Fxxx\u002FDesktop\",\n        \"MINIMAX_API_HOST\": \"API 主机地址 (国内: https:\u002F\u002Fapi.minimaxi.com | 国际: https:\u002F\u002Fapi.minimax.io)\",\n        \"MINIMAX_API_RESOURCE_MODE\": \"可选，[url|local]。默认为 url，设为 local 则音频\u002F图片\u002F视频下载到本地\"\n      }\n    }\n  }\n}\n```\n\n### 方式二：Cursor 配置\n\n1.  打开设置：`Cursor` -> `Preferences` -> `Cursor Settings` -> `MCP`。\n2.  点击 `Add new global MCP Server`。\n3.  填入与上述 Claude Desktop 相同的配置内容（Command, Args, Env 变量）。\n\n## 基本使用\n\n配置完成后，重启你的 MCP 客户端（如 Claude Desktop 或 Cursor），即可在对话框中直接通过自然语言调用以下工具：\n\n### 可用工具列表\n\n| 工具名称 | 功能描述 |\n| :--- | :--- |\n| `text_to_audio` | 文本转语音（TTS） |\n| `list_voices` | 列出所有可用音色 |\n| `voice_clone` | 使用音频文件克隆声音 |\n| `generate_video` | 根据提示词生成视频 |\n| `text_to_image` | 根据提示词生成图片 |\n| `music_generation` | 根据提示词和歌词生成音乐 |\n| `voice_design` | 根据描述生成定制音色 |\n\n### 使用示例\n\n在聊天窗口中直接输入指令即可，无需编写代码：\n\n**示例 1：生成语音**\n> “请用温柔的女声把这段文字读出来：‘欢迎使用 MiniMax MCP 工具。’\"\n\n**示例 2：生成视频**\n> “生成一个视频，画面是一只猫在夕阳下的草地上奔跑，时长 6 秒。”\n\n**示例 3：声音克隆**\n> “我想克隆这个音频文件里的声音（上传音频文件），然后用它朗读这段新闻稿。”\n\n**示例 4：生成图片**\n> “画一张赛博朋克风格的城市夜景图，分辨率要高。”\n\n客户端会自动调用后台的 `minimax-mcp` 服务，处理完成后会将生成的音频、视频或图片直接展示在对话中或保存到指定的 `MINIMAX_MCP_BASE_PATH` 目录。","一位独立开发者正在构建一个自动化短视频生成助手，旨在将新闻文本自动转化为包含解说配音、配图和动态片头的完整视频。\n\n### 没有 MiniMax-MCP 时\n- **接口调用繁琐**：开发者需要分别阅读文本转语音、图像生成和视频生成三份独立的 API 文档，手动编写大量胶水代码来处理鉴权和请求格式。\n- **工作流断裂**：不同模态的数据（音频文件、图片 URL）需要在本地临时存储并手动传递，导致代码逻辑支离破碎，难以维护。\n- **调试效率低下**：一旦某个环节（如视频合成）失败，很难快速定位是参数错误还是网络问题，缺乏统一的上下文监控。\n- **扩展性差**：若想更换模型版本或调整生成参数，必须修改多处硬编码配置，极易引入新 Bug。\n\n### 使用 MiniMax-MCP 后\n- **统一交互协议**：通过标准的 MCP 协议，开发者只需一次配置即可让 AI 代理直接调用 MiniMax 的文本转语音、图像及视频生成能力，无需重复造轮子。\n- **流程自动化闭环**：AI 代理能自动串联“写脚本→生配音→绘插图→剪视频”的全流程，中间数据在上下文中无缝流转，无需本地文件中转。\n- **智能错误处理**：当生成任务受阻时，MiniMax-MCP 能基于上下文自动重试或调整参数，大幅降低了人工干预频率。\n- **敏捷迭代开发**：新增功能仅需更新 MCP 配置描述，底层 API 变更对上层业务逻辑透明，显著提升了开发速度。\n\nMiniMax-MCP 通过将多模态生成能力标准化为统一接口，让开发者从复杂的 API 集成中解放出来，专注于创意逻辑的实现。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FMiniMax-AI_MiniMax-MCP_cde8e252.webp","MiniMax-AI","MiniMax","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FMiniMax-AI_89eac755.jpg","Intelligence with Everyone",null,"model@minimax.io","MiniMax_AI","https:\u002F\u002Fwww.minimax.io","https:\u002F\u002Fgithub.com\u002FMiniMax-AI",[83,87],{"name":84,"color":85,"percentage":86},"Python","#3572A5",95.5,{"name":88,"color":89,"percentage":90},"Shell","#89e051",4.5,1400,249,"2026-04-11T00:20:57","MIT","Linux, macOS, Windows","未说明",{"notes":98,"python":99,"dependencies":100},"该工具为 MCP 服务器，主要通过 API 调用 MiniMax 云端服务（语音、视频、图像生成），本地无需高性能 GPU 或大显存。必须配置正确的 API Key 和对应的区域 API 主机地址（全球版或中国大陆版），否则会导致认证失败。Windows 用户需在 Claude Desktop 中启用开发者模式。支持 stdio 和 SSE 两种传输模式。","未说明 (需安装 uv 包管理器以运行 uvx 命令)",[101,102],"uv","minimax-mcp",[61,15,104],"音频",[106,107,108,109,110,111,112,113,114,115],"image-generation","mcp","mcp-server","mcp-tools","text-to-speech","video-generation","image-to-video","text-to-image","text-to-video","voice-cloning","2026-03-27T02:49:30.150509","2026-04-12T07:50:38.849838",[119,124,129,134,139,144,149],{"id":120,"question_zh":121,"answer_zh":122,"source_url":123},30384,"如何控制 TTS 语音生成的稳定性，避免每次生成结果在语速和语调上有细微差别？","语音大模型的生成具有随机性，目前尚未提供控制随机性的参数（如 seed）。若使用 MCP，参数可能由 LLM 控制导致波动。建议：1. 在输入中严格指定参数（参考官方 t2a api 文档）；2. 接受当前版本存在的固有随机性，未来可能会开放相关设定。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP\u002Fissues\u002F25",{"id":125,"question_zh":126,"answer_zh":127,"source_url":128},30385,"使用 text_to_image 工具时，生成的文件未保存到本地指定目录，只返回了无法访问的 URL，如何解决？","需要将环境变量 `MINIMAX_API_RESOURCE_MODE` 设置为 `local` 并重启客户端。配置示例：`\"MINIMAX_API_RESOURCE_MODE\": \"local\"`。设置后，生成的图片将直接保存到指定的输出目录中。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP\u002Fissues\u002F14",{"id":130,"question_zh":131,"answer_zh":132,"source_url":133},30386,"在 Cline 客户端中使用 Python 版 MCP Server 遇到兼容性问题或报错怎么办？","Cline 目前对 Python 版的 MCP Server 存在适配兼容问题。解决方案有两种：1. 更换其他 MCP 客户端；2. 在 Cline 上改用 JS 版本的 MCP，功能相同。JS 版地址：https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP-JS","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP\u002Fissues\u002F2",{"id":135,"question_zh":136,"answer_zh":137,"source_url":138},30387,"如何在 Dify 平台中配置并使用 MiniMax-MCP？","在 Dify 中集成 MiniMax-MCP 可参考官方关于使用 Zapier MCP 的最佳实践文档，配置逻辑相似。参考链接：https:\u002F\u002Fdocs.dify.ai\u002Fplugins\u002Fbest-practice\u002Fhow-to-use-mcp-zapier。请确保在配置中正确填写 API Key 及相关环境变量。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP\u002Fissues\u002F7",{"id":140,"question_zh":141,"answer_zh":142,"source_url":143},30388,"遇到 'Failed to list voices: API Error: 2049-invalid api key' 错误提示无效 API Key 怎么办？","该错误通常由 API Key 配置错误或过期引起。请检查环境变量中的 `MINIMAX_API_KEY` 是否填写正确且有效。若问题持续，请参考项目最新的 README 文档中的配置说明进行核对，或联系官方支持获取帮助。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP\u002Fissues\u002F8",{"id":145,"question_zh":146,"answer_zh":147,"source_url":148},30389,"调用 understand_image (VLM) 接口时返回 1033 Gemini API error 错误，如何解决？","该错误表明 MiniMax 服务端在调用底层 Google Gemini API 时返回了 400 错误，可能由于图片 URL 无效或 Base64 格式问题导致。建议检查图片链接是否公开可访问，或尝试转换图片格式。若问题依旧，需等待官方修复服务端与 Gemini 接口的对接问题。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP\u002Fissues\u002F42",{"id":150,"question_zh":151,"answer_zh":152,"source_url":153},30390,"MCP 客户端显示 'No tools available' 没有任何可用工具，是什么原因？","这通常是因为 MCP 客户端配置不正确或未成功连接到服务器。请确认您的 MCP 客户端类型（如 Cursor, Mac OS 等），检查是否有额外的错误信息或截图。在某些环境下（如 Mac OS + Cursor），重新配置或重启后通常可恢复正常。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-MCP\u002Fissues\u002F4",[]]