🚀 快速上手指南（Claude Desktop）

本指南将帮助您快速上手使用 Claude Desktop 并集成 ElevenLabs 的 API 服务，让您能够顺利使用相关功能。

🚀 快速开始

1. 获取 API 密钥

从 ElevenLabs 获取您的 API 密钥。免费层提供每月 10,000 信用额度。

2. 安装 uv

安装 uv（Python 包管理器），使用以下命令：

curl -LsSf https://astral.sh/uv/install.sh | sh

或参考 uv 仓库 获取其他安装方法。

3. 配置 Claude Desktop

打开 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 使用了。

💻 使用示例

日志文件路径

• 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"）。这样可以确保引用正确的可执行文件。

🤝 贡献方式

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

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

2. 运行测试以确保一切正常工作：

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

3. 在 Claude Desktop 中安装服务器：mcp install elevenlabs_mcp/server.py
4. 使用 MCP 检查器本地调试和测试：mcp dev elevenlabs_mcp/server.py

🛠️ 故障排除

• Windows：日志位于 %APPDATA%\Claude\logs\mcp-server-elevenlabs.log
• macOS：日志位于 ~/Library/Logs/Claude/mcp-server-elevenlabs.log