金大哥 - OpenAI TTS MCP 详情

article

README

🚀 tts-mcp 中文翻译

一个模型上下文协议（MCP）服务器和命令行工具，用于借助 OpenAI TTS API 实现高质量的文本转语音生成。

🚀 快速开始

本项目提供了一个模型上下文协议（MCP）服务器和命令行工具，可利用 OpenAI TTS API 进行高质量的文本转语音生成。以下为你介绍如何快速上手。

✨ 主要特性

MCP 服务器：可与 Claude Desktop 以及其他 MCP 兼容客户端集成文本转语音功能。
语音选项：支持多种语音角色，如 alloy、nova、echo 等。
高质量音频：支持多种输出格式，包括 MP3、WAV、OPUS、AAC 等。
可配置性：能够对语速、语音角色和额外指令进行配置。
CLI 工具：可作为命令行工具直接使用，实现文本转语音转换。

📦 安装指南

方法 1：从仓库安装

# 克隆仓库
git clone https://github.com/nakamurau1/tts-mcp.git
cd tts-mcp

# 安装依赖项
npm install

# 可选：全局安装
npm install -g .

方法 2：使用 npx 直接运行（无需安装）

# 直接启动 MCP 服务器
npx tts-mcp tts-mcp-server --voice nova --model tts-1-hd

# 直接使用 CLI 工具
npx tts-mcp -t "Hello, world" -o hello.mp3

💻 使用示例

MCP 服务器用法

MCP 服务器允许您将文本转语音功能与模型上下文协议（MCP）兼容客户端集成。

安装依赖项

npm install openai@^6.25.0

启动服务器

node src/index.js

MCP 服务器选项

| 属性 | 详情 | |------|------| | 端口（--port） | 服务监听的端口，默认为 3000 | | 模型（--model） | 使用的模型名称，默认为 "gpt-4o-mini-tts" | | 语音（--voice） | 语音角色，默认为 "alloy" | | 语速（--speed） | 语速（范围：0.25 - 4.0），默认为 1 | | 格式（--format） | 输出格式，默认为 "mp3" | | 指令（--instructions） | 语音生成的额外指令 | | API 密钥（--api-key） | OpenAI API 密钥（也可通过环境变量配置） |

支持的语音角色

alloy（默认）
ash
coral
echo
fable
onyx
nova
sage
shimmer

支持的模型

tts-1
tts-1-hd
gpt-4o-mini-tts（默认）

输出格式

mp3（默认）
opus
aac
flac
wav
pcm

环境变量

您也可以通过系统环境变量配置工具：

export OPENAI_API_KEY=your-api-key-here

📄 许可证

本项目采用 MIT 许可证。

OpenAI TTS