ElevenLabs MCP 音频处理服务器

一个官方的模型上下文协议（MCP）服务器， enables 人工智能客户端与 ElevenLabs 的文本转语音和音频处理 API 进行交互，从而实现语音生成、声音克隆、音频转录及其他与音频相关的任务。

speech-processing

503 查看 · 2026-07-07 更新

简介

export

官方 ElevenLabs Model Context Protocol (MCP) 服务器，可与强大的文本转语音和音频处理 API 进行交互。此服务器允许像 Claude Desktop、Cursor、Windsurf、OpenAI Agents 等 MCP 客户端生成语音、克隆声音、转录音频等。

使用 Claude Desktop 快速入门

从 ElevenLabs 获取您的 API 密钥。每月有 10,000 积分的免费层级。
安装 uv（Python 包管理器），通过运行 curl -LsSf https://astral.sh/uv/install.sh | sh 或参阅 uv 仓库以获取其他安装方法。
前往 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 的积分。

尝试询问 Claude：

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

可选功能

您可以将 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: spawn uvx ENOENT

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

which uvx

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

服务配置

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

来源

来源：github
链接：https://github.com/elevenlabs/elevenlabs-mcp