📢 Blabber-MCP 🗣️

一个 MCP 服务器，通过 OpenAI 的文本转语音 API 为你的 LLM 提供语音功能！ 🔊

✨ 功能

• 文本转语音： 将输入的文本转换为高质量的语音音频。

• 声音选择： 可从多种 OpenAI 声音中选择（alloy、echo、fable、onyx、nova、shimmer）。

• 模型选择： 使用标准模型 (tts-1) 或高清模型 (tts-1-hd)。

• 格式选项： 获取 mp3、opus、aac 或 flac 格式的音频输出。

• 文件保存： 将生成的音频保存到本地文件。

• 可选播放： 使用可配置的系统命令自动播放生成的音频。

• 可配置默认值： 通过配置设置默认声音。

Related MCP server: NijiVoice-MCP

🔧 配置

要使用此服务器，你需要将其配置添加到 MCP 客户端的设置文件中（例如 mcp_settings.json）。

1. 获取 OpenAI API 密钥： 你需要从 OpenAI 获取 API 密钥。

2. 添加到 MCP 设置： 将以下代码块添加到设置文件中的 mcpServers 对象中，并将 "YOUR_OPENAI_API_KEY" 替换为你的实际密钥。

{
  "mcpServers": {
    "blabber-mcp": {
      "command": "node",
      "args": ["/full/path/to/blabber-mcp/build/index.js"], (IMPORTANT: Use the full, absolute path to the built index.js file)
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY",
        "AUDIO_PLAYER_COMMAND": "xdg-open", (Optional: Command to play audio (e.g., "cvlc", "vlc", "mpv", "ffplay", "afplay", "xdg-open"; defaults to "cvlc")
        "DEFAULT_TTS_VOICE": "nova" (Optional: Set default voice (alloy, echo, fable, onyx, nova, shimmer); defaults to nova)
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

重要提示： 请确保 args 路径指向 blabber-mcp 项目目录中 build/index.js 文件的正确位置。请使用完整的绝对路径。

🚀 使用方法

配置并运行后，你可以通过 MCP 客户端使用 text_to_speech 工具。

工具： text_to_speech 服务器： blabber-mcp（或你在配置中使用的键名）

参数：

• input (字符串，必填)：要合成的文本。

• voice (字符串，可选)：要使用的声音（alloy、echo、fable、onyx、nova、shimmer）。默认为配置中设置的 DEFAULT_TTS_VOICE，或 nova。

• model (字符串，可选)：模型（tts-1、tts-1-hd）。默认为 tts-1。

• response_format (字符串，可选)：音频格式（mp3、opus、aac、flac）。默认为 mp3。

• play (布尔值，可选)：设置为 true 以在保存后自动播放音频。默认为 false。

工具调用示例（带播放功能）：

<use_mcp_tool>
  <server_name>blabber-mcp</server_name>
  <tool_name>text_to_speech</tool_name>
  <arguments>
  {
    "input": "Hello from Blabber MCP!",
    "voice": "shimmer",
    "play": true
  }
  </arguments>
</use_mcp_tool>

输出：

该工具将音频文件保存到 blabber-mcp 项目文件夹内的 output/ 目录中，并返回如下 JSON 响应：

{
  "message": "Audio saved successfully. Playback initiated using command: cvlc",
  "filePath": "path/to/speech_1743908694848.mp3", 
  "format": "mp3",
  "voiceUsed": "shimmer"
}

📜 许可证

本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。

🕒 更新日志

有关版本历史的详细信息，请参阅 CHANGELOG.md 文件。