clade MCP server whatsapp-minimax cloned voice

完整指南：克劳德桌面MCP设置WhatsApp语音消息与克隆的声音

概述

本综合指南记录了使用MCP（模型上下文协议）服务器为WhatsApp和Minimax集成设置Claude Desktop的完整过程。目标是通过Claude Desktop直接通过WhatsApp使用克隆语音发送个性化语音消息。

你将取得什么成就

• ✅ 使用WhatsApp MCP服务器配置克劳德桌面
• ✅ 集成Minimax MCP服务器用于AI语音生成
• ✅ 克隆您的语音并将其用于消息生成
• ✅ 直接向WhatsApp联系人发送自定义音频消息
• ✅ 处理常见的设置问题和故障排除

先决条件

• macOS或Linux系统
• 已安装Claude Desktop
• 已安装Python 3.8+
• Git已安装
• WhatsApp帐户
• 具有API访问权限的Minimax帐户

所需资源

• WhatsApp MCP服务器:
• 最小最大MCP服务器:
• 视频示例: https://www.youtube.com/watch?v=1xwAl284fJ8

步骤1:安装uv包管理器

首先，安装 uv 用于运行MCP服务器的包管理器：

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Add to PATH (add to your ~/.bashrc or ~/.zshrc)
export PATH="$HOME/.local/bin:$PATH"

# Reload shell or run:
source ~/.bashrc  # or ~/.zshrc

常见问题：如果 uv 如果找不到，请确保正确设置了PATH并重新启动终端。

步骤2：设置WhatsApp MCP服务器

2.1克隆和设置存储库

# Clone the repository
cd ~/
mkdir -p github_com_lharries_whatsapp-mcp
cd github_com_lharries_whatsapp-mcp
git clone https://github.com/lharries/whatsapp-mcp.git whatsapp-mcp-server
cd whatsapp-mcp-server

2.2安装依赖项

# Install Python dependencies using uv
uv sync

故障排除：如果您遇到依赖关系问题：

• 确保已安装Python 3.8+
• 尝试： uv pip install -r requirements.txt
• 检查是否满足所有系统依赖关系

2.3 WhatsApp身份验证设置

WhatsApp MCP服务器需要通过WhatsApp Web进行身份验证。请按照以下步骤操作：

1. 首先运行服务器以生成二维码：

uv run main.py

1. 使用WhatsApp移动应用程序扫描二维码
2. 等待身份验证成功
3. 会话将被保存以备将来使用

常见问题:

• 二维码未显示：检查防火墙设置并确保端口访问
• 身份验证失败：尝试清除浏览器缓存并重新生成二维码
• 会话到期：您可能需要定期重新进行身份验证

步骤3：设置Minimax MCP服务器

3.1获取Minimax API密钥

1. 注册地址： Minimax人工智能平台
2. 导航到API设置
3. 生成API密钥
4. 安全地保存密钥（您需要它进行配置）

3.2安装Minimax MCP服务器

# Install using uvx
uvx install minimax-mcp

如果uvx失败，则进行替代安装:

# Clone repository method
git clone https://github.com/MiniMax-AI/MiniMax-MCP.git
cd MiniMax-MCP
uv sync

步骤4：配置Claude桌面

4.1找到Claude桌面配置

查找您的Claude Desktop配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

4.2创建/更新配置文件

创建或更新包含以下内容的配置文件：

{
  "mcpServers": {
    "whatsapp": {
      "command": "/Users/[YOUR_USERNAME]/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/[YOUR_USERNAME]/github_com_lharries_whatsapp-mcp/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    },
    "MiniMax": {
      "command": "/Users/[YOUR_USERNAME]/.local/bin/uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "YOUR_MINIMAX_API_KEY_HERE",
        "MINIMAX_MCP_BASE_PATH": "/tmp",
        "MINIMAX_API_HOST": "https://api.minimaxi.chat",
        "MINIMAX_API_RESOURCE_MODE": "local"
      }
    }
  }
}

重要：替换 [YOUR_USERNAME] 使用您的实际用户名和 YOUR_MINIMAX_API_KEY_HERE 使用您的实际Minimax API密钥。

4.3配置故障排除

常见问题:

1. 路径问题:

- 确保所有路径都使用绝对路径 - 验证 uv 和 uvx 安装在 ~/.local/bin/ - 检查目录结构是否完全匹配

1. JSON语法错误:

- 使用在线验证器验证JSON语法 - 确保所有引号都正确转义 - 检查尾随逗号

1. 环境变量:

- 验证API密钥是否正确且处于活动状态 - 确保基本路径 /tmp 存在并且可写 - 检查API主机URL是否可访问

步骤5：语音克隆设置（可选但推荐）

5.1准备语音样本

1. 录制清晰的语音样本（10-30秒）
2. 使用优质麦克风
3. 说话清晰自然
4. 另存为MP3或WAV格式

5.2克隆你的声音

一旦Claude Desktop与MCP服务器一起运行：

1. 让克劳德列出可用的声音：

   Can you list all available voices in Minimax?

1. 克隆您的声音：

   Can you clone my voice using this audio file? [upload your voice sample]
   Use voice ID: my_custom_voice_[your_name]

1. 测试克隆语音：

   Generate a test audio message with my cloned voice saying "Hello, this is a test message"

步骤6：重新启动克劳德桌面

1. 完全关闭克劳德桌面
2. 重新启动应用程序
3. 等待MCP服务器初始化
4. 检查两台服务器是否已连接（您应该在Claude中看到MCP指示灯）

步骤7：测试集成

7.1测试WhatsApp连接

Can you search for contacts in my WhatsApp?

7.2测试最小最大语音生成

Can you generate an audio message saying "Hello, this is a test" using my cloned voice?

7.3发送测试语音消息

Can you send a voice message to [phone number] saying "Hello, this is a test message from Claude" using my cloned voice?

完整工作示例

以下是我们取得成功的确切过程：

初始请求

User: "Can you send an audio message with my cloned voice to +34959217658 with the message 'Hemos llegado a los 140.000 seguidores en instagram. Que chimba!! Gracias a la divinidad'"

逐步执行

1. 语音发现:

   Claude listed available voices and found the cloned voice: moss_audio_17d8fcf2-4abf-11f0-b862-46ba4da2d9df

1. 音频生成:

   Parameters used:
   - Text: "Hemos llegado a los 140.000 seguidores en instagram. Que chimba!! Gracias a la divinidad"
   - Voice ID: moss_audio_17d8fcf2-4abf-11f0-b862-46ba4da2d9df
   - Emotion: happy
   - Language: Spanish

1. WhatsApp交付:

   Sent to: 34959217658 (without + prefix)
   Format: Audio message
   Result: Success

1. 内容更正:

   User requested change from "140.000 seguidores" to "140 mil seguidores"
   Regenerated audio with corrected text
   Sent updated message successfully

常见问题及解决方法

问题1:MCP服务器未连接

症状：Claude Desktop显示没有连接MCP服务器

解决方案:

1. 检查配置文件语法
2. 验证所有路径是否绝对正确
3. 确保 uv 和 uvx 已正确安装
4. 完全重新启动克劳德桌面
5. 检查系统日志中的错误消息

问题2:WhatsApp身份验证失败

症状：无法连接到WhatsApp，二维码问题

解决方案:

1. 清除手机中的WhatsApp Web会话
2. 确保良好的互联网连接
3. 请先尝试手动运行WhatsApp MCP服务器
4. 检查防火墙/防病毒设置

问题3：API最大错误

症状：语音生成失败，API错误

解决方案:

1. 验证API密钥是否正确且处于活动状态
2. 检查账户贷方余额
3. 确保API主机URL可访问
4. 如果权限问题，请尝试不同的基本路径

问题4：语音克隆不起作用

症状：找不到克隆语音，生成失败

解决方案:

1. 确保语音在Minimax平台中正确克隆
2. 检查语音ID格式
3. 验证音频文件格式兼容性
4. 尝试列出声音以确认可用性

问题5：音频消息传递失败

症状：音频生成，但WhatsApp发送失败

解决方案:

1. 检查电话号码格式（无+前缀）
2. 确保WhatsApp会话处于活动状态
3. 验证音频文件格式兼容性
4. 检查文件权限和路径

最佳实践

1. 定期备份：保存您的Claude Desktop配置
2. API密钥安全：永远不要共享您的Minimax API密钥
3. 语音质量：使用高质量音频进行语音克隆
4. 测试：在发送给他人之前，始终先对自己进行测试
5. 更新：定期更新MCP服务器

故障排除命令

检查紫外线安装：

which uv
uv --version

检查uvx安装：

which uvx
uvx --version

手动测试WhatsApp MCP：

cd ~/github_com_lharries_whatsapp-mcp/whatsapp-mcp-server
uv run main.py

手动测试最小最大MCP：

uvx minimax-mcp -y

验证Claude配置：

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python -m json.tool

成功指标

在以下情况下，您将知道一切正常：

• ✅ Claude Desktop显示两台MCP服务器已连接
• ✅ 您可以搜索WhatsApp联系人
• ✅ 您可以列出可用的声音，包括克隆的声音
• ✅ 您可以用语音生成音频
• ✅ 您可以成功向WhatsApp发送音频消息

结论

此设置通过将Claude的智能与WhatsApp的覆盖范围和Minimax的语音克隆技术相结合，实现了强大的自动化功能。成功的关键是仔细关注配置细节，并对出现的任何问题进行系统的故障排除。

完全集成允许向Claude发送自然语言命令，从而将个性化语音消息直接发送给WhatsApp联系人，为自动化客户服务、个人助理和创意内容分发开辟了可能性。