使用说明

项目简介

MCP文本转语音服务器（MCPTTS）是一个实现了Model Context Protocol (MCP) 的后端应用，旨在为大型语言模型（LLM）客户端提供文本转语音（TTS）的功能。通过注册并执行 'quick_speak' 工具，该服务器允许LLM客户端调用macOS内置的 'say' 命令，将指定的文本转换为语音并播放出来。

主要功能点

文本转语音工具: 提供 'quick_speak' 工具，允许LLM客户端将文本合成为语音。
多语言支持: 'quick_speak' 工具支持多种语言（目前代码中预设了英语和葡萄牙语），可以根据指定的语言参数选择合适的语音进行播报。
MCP服务器: 作为一个MCP服务器，它遵循MCP协议，可以与任何兼容MCP协议的LLM客户端进行通信，提供标准化的工具调用服务。
易于安装和配置: 提供简单的安装步骤和配置方法，可以快速部署并与LLM客户端集成。

安装步骤

克隆仓库:

git clone https://github.com/tonylampada/mcptts
cd mcptts

创建并激活虚拟环境 (推荐使用uv):

uv venv
source .venv/bin/activate

安装依赖:

uv pip install -r requirements.txt

服务器配置

要将 MCPTTS 服务器与 MCP 客户端（例如 Claude）连接，您需要在客户端的配置文件中指定服务器的启动命令和参数。以下是 Claude 客户端的配置示例，您需要根据实际情况修改路径：

{
  "tts": {
    "server name": "MCPTTS",
    "command": "/path/to/mcptts/.venv/bin/python",
    "args": ["/path/to/mcptts/mcp_server.py"]
  }
}

配置参数说明:

'server name': 服务器名称，可以自定义，例如 "MCPTTS"。
'command': Python 解释器的路径。请确保指向您在安装步骤中创建的虚拟环境中的 Python 解释器。示例中的 '/path/to/mcptts/.venv/bin/python' 需要替换为您的实际路径。
'args': 启动 'mcp_server.py' 脚本的参数，这里指定了服务器脚本的路径。示例中的 '/path/to/mcptts/mcp_server.py' 需要替换为您的实际路径。

请务必将 '/path/to/mcptts' 替换为您克隆 'mcptts' 仓库的实际本地路径。

基本使用方法

确保 MCPTTS 服务器已按照上述步骤配置并在运行。
在您的 MCP 客户端（例如 Claude）中，当需要使用文本转语音功能时，客户端将调用 MCPTTS 服务器提供的 'quick_speak' 工具。
'quick_speak' 工具接受 'text'（要播报的文本）和 'language'（语言代码，如 "en" 或 "pt"）作为参数。
服务器将使用 macOS 的 'say' 命令将文本转换为语音并播放，然后返回执行结果给客户端。

注意: 该服务器依赖 macOS 操作系统及其 'say' 命令，因此只能在 macOS 环境下运行。

关键词