使用说明

项目简介

Project Jessica (ElevenLabs TTS MCP) 是一个基于 Model Context Protocol (MCP) 的后端服务，它集成了 ElevenLabs 的文本转语音 (Text-to-Speech, TTS) 功能。该项目旨在为支持 MCP 协议的 LLM 客户端（如 Cursor 编辑器）提供文本转语音的能力，允许用户通过 LLM 客户端调用 ElevenLabs 的 TTS 服务，实现文本到语音的转换。

主要功能点

文本转语音 (TTS): 使用 ElevenLabs API 将文本转换为高质量的语音。
语音选择和管理: 支持选择不同的 ElevenLabs 语音模型。
MCP 协议集成: 通过 MCP 协议与 LLM 客户端 (如 Cursor) 无缝集成，提供标准化的服务接口。
实时通信: 使用 WebSocket 实现音频流的实时传输。
可配置性: 允许用户配置 ElevenLabs API 密钥、服务器端口等。

安装步骤

克隆仓库:

git clone https://github.com/georgi-io/elevenlabs-tts-mcp.git
cd elevenlabs-tts-mcp

配置后端 (Backend):

cd jessica
python -m venv .venv
source .venv/bin/activate  # 或在 Windows 上运行 .venv\Scripts\activate
poetry install
cp .env.example .env
# 编辑 .env 文件，填入你的 ElevenLabs API 密钥
# ELEVENLABS_API_KEY=your-api-key

配置前端 (Frontend):

cd src/frontend
npm install
cd ../.. # 返回项目根目录

服务器配置 (MCP 客户端配置)

要将此 MCP 服务器添加到 MCP 客户端（例如 Cursor），您需要配置客户端连接到服务器。以下是配置信息示例 (JSON 格式)，请根据您的 MCP 客户端进行配置：

{
  "serverName": "Jessica TTS",  // MCP 服务器的名称，可以自定义
  "command": "python",      // 启动 MCP 服务器的命令
  "args": ["-m", "src.backend"], // 启动命令的参数，指向后端入口
  "type": "SSE",           // MCP 服务器的传输协议，这里使用 Server-Sent Events (SSE)
  "url": "http://localhost:9022/sse" // MCP 服务器的 SSE 端点 URL
}

注意:

请确保在运行 MCP 客户端之前，先启动 MCP 服务器。
'command' 和 'args' 需要根据您的 Python 环境和项目路径进行调整。
'url' 需要与您运行的 MCP 服务器的地址和端口一致 (默认为 'http://localhost:9022/sse')。

基本使用方法

启动后端服务器:

cd jessica
source .venv/bin/activate  # 或在 Windows 上运行 .venv\Scripts\activate
python -m src.backend

启动后，MCP 服务器将在 'http://localhost:9022/sse' 运行。

配置 MCP 客户端 (以 Cursor 为例):
- 打开 Cursor 编辑器的设置。
- 找到 MCP 服务器配置项（通常在 "Extensions" 或 "Experimental" 设置中）。
- 点击 "Add Server" 或类似按钮。
- 填入上述 服务器配置 (MCP 客户端配置) JSON 信息。
在 Cursor 中使用 TTS 功能:
- 配置完成后，Cursor 应该能够检测到 "Jessica TTS" MCP 服务器。
- 具体使用方式取决于 Cursor 如何集成 MCP 工具。通常，您可能需要在 Cursor 的命令面板或上下文菜单中找到与 "speak_text" 或类似的 TTS 工具，并使用它将选定的文本转换为语音。

请参考 Cursor 编辑器或其他 MCP 客户端的文档，了解如何具体使用集成的 MCP 服务器功能。

关键词