tts-mcp

tts-mcp

site icon
2025.03.25 0
TypeScript文本转语音语音生成MCP 服务器内容生成
tts-mcp 是一个基于 Model Context Protocol (MCP) 的服务器和命令行工具,用于通过 OpenAI TTS API 实现高质量的文本转语音功能。它支持多种语音角色、音频格式和自定义配置,适用于需要文本转语音功能的开发者和用户。
View on GitHub

Overview

基本能力

产品定位

tts-mcp 是一个文本转语音(TTS)工具,旨在为开发者和用户提供高质量的语音生成服务,支持与 MCP 兼容的客户端(如 Claude Desktop)集成。

核心功能

  • MCP 服务器:提供文本转语音功能,支持与 MCP 兼容的客户端集成。
  • 多种语音选项:支持多种语音角色(如 alloy、nova、echo 等)。
  • 高质量音频:支持多种输出格式(MP3、WAV、OPUS、AAC 等)。
  • 自定义配置:可配置语音速度、语音角色和其他生成参数。
  • 命令行工具:提供独立的命令行工具,直接进行文本转语音转换。

适用场景

  • 需要将文本内容转换为语音的应用或服务。
  • 与 MCP 兼容的客户端(如 Claude Desktop)集成。
  • 开发者或用户需要快速生成语音文件。

工具列表

  • text-to-speech:用于将文本转换为语音并播放的工具。

常见问题解答

  • 如何提供 API 密钥:可以通过命令行参数 --api-key 或环境变量 OPENAI_API_KEY 提供。
  • 如何配置语音角色:使用 --voice 参数指定语音角色(如 nova)。
  • 如何设置输出格式:使用 --format 参数指定输出格式(如 mp3)。

使用教程

使用依赖

  • 需要安装 Node.js 和 npm。

安装教程

方法 1:从仓库安装

git clone https://github.com/nakamurau1/tts-mcp.git
cd tts-mcp
npm install
npm install -g .

方法 2:直接使用 npx(无需安装)

npx tts-mcp tts-mcp-server --voice nova --model tts-1-hd
npx tts-mcp -t "Hello, world" -o hello.mp3

调试方式

启动 MCP 服务器

npm run server
npm run server -- --voice nova --model tts-1-hd
node bin/tts-mcp-server.js --voice echo --api-key your-openai-api-key

使用 CLI 工具

tts-mcp -t "Hello, world" -o hello.mp3
tts-mcp -f speech.txt -o speech.mp3
tts-mcp -t "Welcome to the future" -o welcome.mp3 -v nova

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。