项目简介

Murf MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端应用，它将强大的 Murf AI 文本转语音 (TTS) 能力封装成标准的 MCP 工具。通过与支持 MCP 的 LLM 客户端（如 Claude Desktop）集成，用户可以直接在聊天界面中调用 Murf AI 进行高质量的语音生成、语音搜索和音频播放。

主要功能点

• 文本转语音 (TTS): 将文本输入转换为逼真自然的语音文件。支持多种语言、口音、风格，并可调整语速、音高、添加停顿等。
• 语音搜索与推荐: 根据描述（如性别、口音、风格、语言等）搜索并推荐合适的语音角色。
• 音频播放: 将生成的音频文件直接在用户的系统中打开播放。

安装步骤

1. 从 Murf AI API Dashboard 获取您的 API 密钥。
2. 安装 Python 包管理器 'uv'。请参照其官方指南安装。
3. 使用 'uv' 运行自动安装脚本 'uvx setup-murf-mcp-claude'，或者进行手动配置（见下一节）。自动安装脚本是推荐方式，它会自动处理大部分设置，包括更新 MCP 客户端配置。
4. 安装 FFmpeg（音频处理所需）：
   • macOS: 使用 Homebrew 命令行工具运行 'brew install ffmpeg'。
   • Windows: 从 FFmpeg 官网 下载并安装。
5. 重启您的 MCP 客户端应用程序（例如 Claude Desktop）。如果配置成功，客户端界面会显示 MCP 服务器已连接的指示（如锤子图标），表示工具已可用。

服务器配置 (供MCP客户端使用)

MCP 客户端需要配置 MCP 服务器的启动信息以便建立连接。对于 Murf MCP 服务器，您需要在客户端的配置文件（通常是 'claude_desktop_config.json'）的 '"mcpServers"' 部分添加如下条目。这里只需提供配置结构和参数说明，客户端会自动启动服务器：

• '"YourServerName"': 这是您为该 MCP 服务器自定义的名称，例如 '"Murf"'。
• '"command"': 启动 MCP 服务器进程的可执行文件或脚本路径。如果使用 'uvx' 安装，通常填写 '"uvx"' 或其绝对路径。
• '"args"': 传递给 '"command"' 的命令行参数列表。对于此项目，通常填写 '["murf-mcp"]'。
• '"env"': 传递给 MCP 服务器进程的环境变量字典。必须包含 '"MURF_API_KEY": "YOUR_MURF_API_KEY"'，请将 '"YOUR_MURF_API_KEY"' 替换为您在步骤1中获取的 Murf API 密钥。

基本使用方法

• 在支持 MCP 工具的 LLM 客户端（如 Claude Desktop）中，像与 LLM 聊天一样，直接提出您关于语音生成、语音搜索或播放音频的需求。
• LLM 会理解您的请求，并自动调用 Murf MCP 服务器提供的相应工具来执行操作。
• 例如，您可以尝试以下提示：
  • "请使用一个男性美式口音为这段文本生成语音：[您的文本]"
  • "我需要一个适合旁白的女性语音，请推荐一些。"
  • "请播放文件路径为 /path/to/your/audio.wav 的音频文件。"
• 文本转语音生成的音频文件通常会保存到您的桌面，并告知您文件路径。