Project Jessica (ElevenLabs TTS MCP)

基本能力

产品定位

Jessica项目是一个文本转语音（TTS）服务，旨在通过MCP协议与Cursor集成，提供高效的语音生成和管理功能。

核心功能

• 使用ElevenLabs API进行文本转语音转换
• 语音选择和管理
• 与Cursor的MCP集成
• 现代化的React前端界面
• WebSocket实时通信
• 代码质量预提交钩子
• 自动代码格式化和linting

适用场景

• 需要文本转语音功能的开发环境
• 需要与Cursor集成的语音服务
• 需要实时语音生成的应用

工具列表

• Poetry: 用于后端依赖管理
• Node.js: 用于前端开发
• Ruff: 用于Python代码的格式化和linting
• Pytest: 用于Python代码的测试
• ESLint: 用于前端代码的linting
• TypeScript: 用于前端类型检查

常见问题解答

1. API Key Issues
2. 错误: "Invalid API key"
3. 解决方案: 检查.env文件
4. Connection Problems
5. 错误: "Cannot connect to MCP server"
6. 解决方案: 验证后端是否运行以及端口是否正确
7. Port Conflicts
8. 错误: "Address already in use"
9. 解决方案: 在.env中更改端口
10. WebSocket Connection Failed
11. 错误: "WebSocket connection failed"
12. 解决方案: 确保后端运行且WebSocket URL正确

使用教程

使用依赖

• Python 3.11+
• Poetry
• Node.js 18+
• Cursor

安装教程

后端设置

# Clone the repository
git clone https://github.com/georgi-io/jessica.git
cd jessica

# Create Python virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install backend dependencies
poetry install

# Configure environment
cp .env.example .env
# Edit .env with your ElevenLabs API key

# Install pre-commit hooks
poetry run pre-commit install

前端设置

# Navigate to frontend directory
cd src/frontend

# Install dependencies
npm install

调试方式

启动后端

# Activate virtual environment if not active
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Start the backend
python -m src.backend

启动前端

# In src/frontend directory
npm run dev

许可证

该项目遵循 MIT 开源许可条款。