tts-mcp

使用 OpenAI TTS API 生成高质量文本转语音的模型上下文协议 (MCP) 服务器和命令行工具。

主要特点

MCP 服务器：将文本转语音功能与 Claude Desktop 和其他兼容 MCP 的客户端集成
语音选项：支持多个语音角色（合金、新星、回声等）
高品质音频：支持各种输出格式（MP3、WAV、OPUS、AAC）
可定制：配置语速、语音特征和附加说明
CLI 工具：也可用作命令行实用程序，用于直接进行文本到语音的转换

安装

方法 1：从存储库安装

# Clone the repository
git clone https://github.com/nakamurau1/tts-mcp.git
cd tts-mcp

# Install dependencies
npm install

# Optional: Install globally
npm install -g .

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

# Start the MCP server directly
npx tts-mcp tts-mcp-server --voice nova --model tts-1-hd

# Use the CLI tool directly
npx tts-mcp -t "Hello, world" -o hello.mp3

MCP 服务器使用情况

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

启动 MCP 服务器

# Start with default settings
npm run server

# Start with custom settings
npm run server -- --voice nova --model tts-1-hd

# Or directly with API key
node bin/tts-mcp-server.js --voice echo --api-key your-openai-api-key

MCP 服务器选项

Options:
  -V, --version       Display version information
  -m, --model <model> TTS model to use (default: "gpt-4o-mini-tts")
  -v, --voice <voice> Voice character (default: "alloy")
  -f, --format <format> Audio format (default: "mp3")
  --api-key <key>     OpenAI API key (can also be set via environment variable)
  -h, --help          Display help information

与 MCP 客户端集成

MCP 服务器可与 Claude Desktop 及其他兼容 MCP 的客户端一起使用。Claude Desktop 集成步骤如下：

打开 Claude Desktop 配置文件（通常位于~/Library/Application Support/Claude/claude_desktop_config.json ）
添加以下配置，包括您的 OpenAI API 密钥：

{
  "mcpServers": {
    "tts-mcp": {
      "command": "node",
      "args": ["full/path/to/bin/tts-mcp-server.js", "--voice", "nova", "--api-key", "your-openai-api-key"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key"
      }
    }
  }
}

或者，您可以使用 npx 进行更简单的设置：

{
  "mcpServers": {
    "tts-mcp": {
      "command": "npx",
      "args": ["-p", "tts-mcp", "tts-mcp-server", "--voice", "nova", "--model", "gpt-4o-mini-tts"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key"
      }
    }
  }
}

您可以通过两种方式提供 API 密钥：

直接方法（建议测试）：使用--api-key参数将其包含在args数组中
环境变量法（更安全）：如上图在env对象中设置

安全注意事项：包含 API 密钥时，请确保配置文件的安全。

重启Claude桌面
当你要求克劳德“大声朗读这段文字”或类似请求时，文本将转换为语音

可用的 MCP 工具

文本转语音：将文本转换为语音并播放的工具

CLI 工具使用

您还可以将 tts-mcp 用作独立的命令行工具：

# Convert text directly
tts-mcp -t "Hello, world" -o hello.mp3

# Convert from a text file
tts-mcp -f speech.txt -o speech.mp3

# Specify custom voice
tts-mcp -t "Welcome to the future" -o welcome.mp3 -v nova

CLI 工具选项

Options:
  -V, --version           Display version information
  -t, --text <text>       Text to convert
  -f, --file <path>       Path to input text file
  -o, --output <path>     Path to output audio file (required)
  -m, --model <n>         Model to use (default: "gpt-4o-mini-tts")
  -v, --voice <n>         Voice character (default: "alloy")
  -s, --speed <number>    Speech speed (0.25-4.0) (default: 1)
  --format <format>       Output format (default: "mp3")
  -i, --instructions <text> Additional instructions for speech generation
  --api-key <key>         OpenAI API key (can also be set via environment variable)
  -h, --help              Display help information

支持的声音

支持以下语音角色：

合金（默认）
灰
珊瑚
回声
寓言
缟玛瑙
新星
圣人
闪光

支持的型号

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

输出格式

支持以下输出格式：

mp3（默认）
作品
音频
flac
音频
脉冲编码调制

环境变量

您还可以使用系统环境变量配置该工具：

OPENAI_API_KEY=your-api-key-here

执照

麻省理工学院

TTS-MCP