ElevenLabs MCP 服务器

使用 Claude Desktop 快速入门

从ElevenLabs获取 API 密钥。我们提供每月 10,000 积分的免费套餐。
安装uv （Python 包管理器），使用curl -LsSf https://astral.sh/uv/install.sh | sh安装，或查看uvrepo以了解其他安装方法。
转到 Claude > 设置 > 开发人员 > 编辑配置 > claude_desktop_config.json 以包含以下内容：

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

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

其他 MCP 客户端

对于 Cursor 和 Windsurf 等其他客户端，请运行：

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

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

示例用法

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

尝试询问克劳德：

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

可选功能

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

贡献

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

克隆存储库：

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

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

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

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

cp .env.example .env
# Edit .env and add your API key

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

./scripts/test.sh
# Or with options
./scripts/test.sh --verbose --fail-fast

在 Claude Desktop 中安装服务器： mcp install elevenlabs_mcp/server.py
使用 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：生成 uvx ENOENT

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

which uvx

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

ElevenLabs MCP Server

Integrations