📢 Blabber-MCP 🗣️

一个使用OpenAI的文本转语音API为您的大语言模型赋予声音的MCP服务器！ 🔊

✨ 特性

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

🔧 配置

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

1. 获取OpenAI API密钥: 您需要从OpenAI获取一个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": []
}
}
}

重要提示: 确保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。

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

xml
<use_mcp_tool>
<server_name>blabber-mcp</server_name>
<tool_name>text_to_speech</tool_name>

{
"input": "Hello from Blabber MCP!",
"voice": "shimmer",
"play": true
}

</use_mcp_tool>

输出:

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

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

📜 许可证

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

🕒 更新日志

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