返回 MCP 目录
public公开dns本地运行

mcp-tts-server

基于MCP协议的文本转语音服务器项目,通过Groq API实现语音合成功能,支持多种音频格式输出。

article

README

🚀 mcp-tts-server

该项目提供了一个基于模型上下文协议(MCP)的文本转语音(TTS)服务器,借助Groq平台实现语音生成,为文本转语音需求提供了高效且功能丰富的解决方案。

🚀 快速开始

本项目是一个基于模型上下文协议(MCP)的文本转语音(TTS)服务器,使用Groq平台进行语音生成。通过简单配置和安装依赖,即可快速运行服务器实现文本转语音功能。

✨ 主要特性

  • 实现了MCP协议的TTS功能,为文本转语音提供了标准化的解决方案。
  • 与Groq API (https://api.groq.com/openai/v1/audio/speech)连接以生成逼真的语音音频,保证了语音的高质量。
  • 提供generate_speech工具,可通过MCP协议访问,方便快捷地实现语音生成。
  • 支持多种音频输出格式(wav、mp3、aac、opus、flac),满足不同场景的需求。
  • 使用@tropicbliss/symphonia库在服务器端直接播放生成的音频(可选功能),增加了使用的灵活性。
  • 需要通过环境变量设置Groq API密钥(GROQ_API_KEY),确保访问的安全性。

📦 安装指南

运行以下命令安装所有必要的依赖项:

bun install

💻 使用示例

基础用法

要使用标准输入输出传输协议运行服务器,请在配置文件中添加以下内容:

{
  "mcpServers": {
    "mcp-tts-server": {
      "command": "bunx",
      "args": [
        "--bun",
        "mcp-tts-server",
      ],
      "env": {
        "GROQ_API_KEY": "gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

📚 详细文档

项目结构

  • src/server.ts:定义了MCP服务器的核心逻辑,包括generate_speech工具以及与Groq API的交互。
  • src/cli.ts:提供用于运行MCP服务器的标准控制台接口。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端