ElevenLabs MCP Server

<div class="title-block" style="text-align: center;" align="center">

</div>

<p align="center"> 官方 ElevenLabs <a href="https://github.com/modelcontextprotocol">模型上下文协议 (MCP)</a> 服务器，支持与强大的文本转语音和音频处理 API 进行交互。此服务器允许 MCP 客户端（如 <a href="https://www.anthropic.com/claude">Claude Desktop</a>、<a href="https://www.cursor.so">Cursor</a>、<a href="https://codeium.com/windsurf">Windsurf</a>、<a href="https://github.com/openai/openai-agents-python">OpenAI Agents</a> 等）生成语音、克隆声音、转录音频等。 </p>

Claude Desktop 快速入门

1. 从 ElevenLabs 获取您的 API 密钥。有一个免费层级，每月提供 10k 个积分。
2. 安装 uv (Python 包管理器)，使用 curl -LsSf https://astral.sh/uv/install.sh | sh 安装，或查看 uv repo 获取其他安装方法。
3. 转到 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，包含以下内容：

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "<在此处插入您的 API 密钥>"
      }
    }
  }
}

如果您使用的是 Windows，则必须在 Claude Desktop 中启用“开发者模式”才能使用 MCP 服务器。单击左上角汉堡菜单中的“帮助”，然后选择“启用开发者模式”。

其他 MCP 客户端

对于其他客户端（如 Cursor 和 Windsurf），请运行：

1. pip install elevenlabs-mcp
2. python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print 获取配置。将其粘贴到 MCP 客户端指定的相应配置目录中。

就是这样。您的 MCP 客户端现在可以通过以下工具与 ElevenLabs 交互：

使用示例

⚠️ 警告：使用这些工具需要 ElevenLabs 积分。

尝试询问 Claude：

• “创建一个像黑色电影侦探一样说话的人工智能代理，并且可以回答有关经典电影的问题”
• “为一位睿智的古代龙角色生成三种声音变体，然后我将选择我最喜欢的声音添加到我的声音库中”
• “将我声音的这段录音转换为听起来像中世纪骑士”
• “创建一个密集丛林中雷暴的声音景观，动物们对天气做出反应”
• “将这段语音转换为文本，识别不同的说话者，然后使用每个人的独特声音将其转换回去”

可选功能

您可以将 ELEVENLABS_MCP_BASE_PATH 环境变量添加到 claude_desktop_config.json 中，以指定 MCP 服务器应查找和输出使用相对路径指定文件的基本路径。

贡献

如果您想贡献或从源代码运行：

1. 克隆存储库：

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

2. 创建一个虚拟环境并安装依赖项 使用 uv：

uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

3. 将 .env.example 复制到 .env 并添加您的 ElevenLabs API 密钥：

cp .env.example .env
# 编辑 .env 并添加您的 API 密钥

4. 运行测试以确保一切正常：

./scripts/test.sh
# 或使用选项
./scripts/test.sh --verbose --fail-fast

5. 在 Claude Desktop 中安装服务器：mcp install elevenlabs_mcp/server.py

6. 使用 MCP Inspector 在本地调试和测试：mcp dev elevenlabs_mcp/server.py

故障排除

使用 Claude Desktop 运行时，日志位于：

• Windows: %APPDATA%\Claude\logs\mcp-server-elevenlabs.log
• macOS: ~/Library/Logs/Claude/mcp-server-elevenlabs.log

使用某些工具时超时

某些 ElevenLabs API 操作（如语音设计和音频隔离）可能需要很长时间才能完成。在开发模式下使用 MCP 检查器时，尽管该工具完成了其预期任务，您可能会收到超时错误。

使用像 Claude 这样的客户端时，不应发生这种情况。

MCP ElevenLabs：spawn uvx ENOENT

如果您遇到错误“MCP ElevenLabs: spawn uvx ENOENT”，请通过在终端中运行以下命令来确认其绝对路径：

which uvx

获得绝对路径（例如，/usr/local/bin/uvx）后，更新您的配置以使用该路径（例如，"command": "/usr/local/bin/uvx"）。这确保引用了正确的执行文件。