AI导哈

文本转语音API服务

ElevenLabs的Model Context Protocol (MCP)服务器，提供文本转语音、语音克隆、音频转录等功能，适用于多种MCP客户端。

  • by nguyendinhsinh361
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 nguyendinhsinh361/elevenlabs-mcp

使用说明

Official ElevenLabs Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech and audio processing APIs. This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents and others to generate speech, clone voices, transcribe audio, and more.

Claude Desktop快速入门

  1. 从获取API密钥 ElevenLabs。有一个免费等级，每月10000学分。
  2. 安装 uv （Python包管理器），安装 curl -LsSf https://astral.sh/uv/install.sh | sh 或查看 uv 仓库 有关其他安装方法。
  3. 转到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等其他客户端，请运行：

  1. pip install elevenlabs-mcp
  2. 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服务器应查找并输出用相对路径指定的文件。

贡献

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

  1. 克隆存储库：
git clone https://github.com/elevenlabs/elevenlabs-mcp
cd elevenlabs-mcp
  1. 创建虚拟环境并安装依赖项 使用紫外线:
uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"
  1. 复制 .env.example 向 .env 并添加您的ElevenLabs API密钥：
cp .env.example .env
# Edit .env and add your API key
  1. 运行测试以确保一切正常：
./scripts/test.sh
# Or with options
./scripts/test.sh --verbose --fail-fast

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

  2. 使用MCP检查器进行本地调试和测试： mcp dev elevenlabs_mcp/server.py

故障排除

使用Claude Desktop运行时的日志可以在以下位置找到：

  • 视窗: %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").这可确保引用正确的可执行文件。

相关 MCP