Quickstart with Claude Desktop

基本能力

产品定位

elevenlabs-mcp 是一个基于 Model Context Protocol (MCP) 的服务器，专注于文本转语音和音频处理功能，为开发者和其他工具提供语音生成和音频处理的接口。

核心功能

• 文本转语音（TTS）
• 语音克隆
• 音频转录
• 音频处理（如声音转换、音效生成）

适用场景

• 为 AI 代理生成语音
• 为角色设计独特的声音
• 音频内容的转录和处理
• 创建音效和背景音乐

工具列表

• 语音生成工具：用于将文本转换为语音。
• 语音克隆工具：用于克隆特定声音。
• 音频转录工具：将语音转换为文本。
• 音频处理工具：用于声音转换和音效生成。

常见问题解答

• 问题：时间超时 某些 ElevenLabs API 操作（如语音设计和音频隔离）可能需要较长时间才能完成。在使用 MCP 检查器时可能会遇到超时错误，但这在使用客户端（如 Claude）时不会发生。

• 问题：MCP ElevenLabs: spawn uvx ENOENT 如果遇到此错误，请确认 uvx 的绝对路径并更新配置以使用该路径。

使用教程

使用依赖

1. 从 ElevenLabs 获取 API 密钥（免费层每月有 10k 积分）。
2. 安装 uv（Python 包管理器）： bash curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

1. 安装 elevenlabs-mcp： bash pip install elevenlabs-mcp
2. 运行以下命令获取配置： bash python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print
3. 将生成的配置粘贴到 MCP 客户端指定的配置目录中。

调试方式

1. 克隆仓库并进入目录： bash git clone https://github.com/elevenlabs/elevenlabs-mcp cd elevenlabs-mcp
2. 创建虚拟环境并安装依赖： bash uv venv source .venv/bin/activate uv pip install -e ".[dev]"
3. 复制 .env.example 到 .env 并添加 API 密钥： bash cp .env.example .env
4. 运行测试： bash ./scripts/test.sh
5. 使用 MCP 检查器进行本地调试： bash mcp dev elevenlabs_mcp/server.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。