# pinkpixel-dev
## 基本信息
- Slug: `pinkpixel-dev-blabber-mcp`
- Source: modelscope
- Publisher: @pinkpixel-dev/blabber-mcp
- Categories: text-to-speech / speech-processing / app-automation
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@pinkpixel-dev/blabber-mcp
## 简介
暂无描述。
## MCP Server 详情

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

<span style="color: #90EE90;">一个使用OpenAI的文本转语音API为您的大语言模型赋予声音的MCP服务器！</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](https://platform.openai.com/api-keys)获取一个API密钥。
2.  **添加到MCP设置:** 在您的设置文件中的`mcpServers`对象下添加以下代码块，并将`"YOUR_OPENAI_API_KEY"`替换为您的实际密钥。

json
{
  "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`。

**示例工具调用（带播放）:**

xml
<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响应：

json
{
  "message": "音频已成功保存。正在使用命令 cvlc 进行播放。",
  "filePath": "path/to/speech_1743908694848.mp3", 
  "format": "mp3",
  "voiceUsed": "shimmer"
}


---

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

本项目采用MIT许可证 - 详情请参阅[LICENSE](LICENSE)文件。

---

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

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

---

<p align="center">由Pink Pixel用心制作 ❤️</p>