<span style="color: #FF69B4;">📢 Blabber-MCP</span> <span style="color: #ADD8E6;">🗣️</span>

<span style="color: #90EE90;">一个 MCP 服务器，使用 OpenAI 的文本转语音 API 为你的 LLM 提供声音！</span> 🔊

---

<span style="color: #FFD700;">✨ 功能</span>

• 文本转语音: 将输入的文本转换为高质量的语音音频。
• 声音选择: 从各种 OpenAI 声音中选择 (alloy, echo, fable, onyx, nova, shimmer)。
• 模型选择: 使用标准 (tts-1) 或高清 (tts-1-hd) 模型。
• 格式选项: 获取 mp3, opus, aac, 或 flac 格式的音频输出。
• 文件保存: 将生成的音频保存到本地文件。
• 可选播放: 使用可配置的系统命令自动播放生成的音频。
• 可配置的默认值: 通过配置设置默认声音。

---

<span style="color: #FFA07A;">🔧 配置</span>

要使用此服务器，你需要将其配置添加到你的 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"], (重要提示：使用构建的 index.js 文件的完整绝对路径)
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY",
        "AUDIO_PLAYER_COMMAND": "xdg-open", (可选：播放音频的命令 (例如, "cvlc", "vlc", "mpv", "ffplay", "afplay", "xdg-open"; 默认为 "cvlc")
        "DEFAULT_TTS_VOICE": "nova" (可选：设置默认声音 (alloy, echo, fable, onyx, nova, shimmer); 默认为 nova)
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

<span style="color: #FF6347;">重要提示：</span> 确保 args 路径指向你的 blabber-mcp 项目目录中 build/index.js 文件的正确位置。 使用完整的绝对路径。

---

<span style="color: #87CEEB;">🚀 用法</span>

配置并运行后，你可以通过你的 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"
}

---

<span style="color: #98FB98;">📜 许可证</span>

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

---

<span style="color: #BA55D3;">🕒 更新日志</span>

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

---

<p align="center">Made with ❤️ by Pink Pixel</p>