MCP 服务器

TTS-MCP

一个模型上下文协议（Model Context Protocol，MCP）服务器，集成了高质量的文本转语音（Text-to-Speech，TTS）功能，可与 Claude Desktop 和其他 MCP 兼容的客户端配合使用，支持多种语音选项和音频格式。

README

tts-mcp

一个模型上下文协议 (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) 兼容的客户端（如 Claude Desktop）集成。

启动 MCP 服务器

# 使用默认设置启动
npm run server

# 使用自定义设置启动
npm run server -- --voice nova --model tts-1-hd

# 或者直接使用 API 密钥
node bin/tts-mcp-server.js --voice echo --api-key your-openai-api-key

MCP 服务器选项

选项:
  -V, --version       显示版本信息
  -m, --model <model> 要使用的 TTS 模型 (默认: "gpt-4o-mini-tts")
  -v, --voice <voice> 语音角色 (默认: "alloy")
  -f, --format <format> 音频格式 (默认: "mp3")
  --api-key <key>     OpenAI API 密钥 (也可以通过环境变量设置)
  -h, --help          显示帮助信息

与 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 Desktop
当您要求 Claude “大声朗读这段文字”或类似请求时，文本将被转换为语音

可用的 MCP 工具

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

CLI 工具用法

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

# 直接转换文本
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

CLI 工具选项

选项:
  -V, --version           显示版本信息
  -t, --text <text>       要转换的文本
  -f, --file <path>       输入文本文件的路径
  -o, --output <path>     输出音频文件的路径 (必需)
  -m, --model <n>         要使用的模型 (默认: "gpt-4o-mini-tts")
  -v, --voice <n>         语音角色 (默认: "alloy")
  -s, --speed <number>    语速 (0.25-4.0) (默认: 1)
  --format <format>       输出格式 (默认: "mp3")
  -i, --instructions <text> 用于语音生成的其他指令
  --api-key <key>         OpenAI API 密钥 (也可以通过环境变量设置)
  -h, --help              显示帮助信息