← 返回目录

Elevenlabs MCP

官方

已归档

官方 ElevenLabs MCP 服务器，用于文本转语音和音频处理

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 1.5k 非常热门
传输方式: stdio（本地进程）
运行环境: Python · 预编译二进制
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 52 天前

66FMRS · C

该服务器是 ElevenLabs 官方提供的 MCP 集成，功能强大，但需要 API 密钥和积分消耗。配置简单，与 Claude Desktop 等客户端兼容良好。适合需要高质量语音合成的用户。

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

14/20

维护活跃度

13/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: README 给出了具体的启动路径（uvx elevenlabs-mcp；python -m elevenlabs_mcp --api-key ... --print），并点名了若干工具（speech_to_text、isolate_audio、speech_to_speech、video_to_music、upload_music_for_inpainting）及输出资源 URI（elevenlabs://filename），因此干净启动与工具列表握手是合理的。但所供材料只有 README 与 manifest，没有 CI 工作流文件、测试文件或源码可供验证；且 manifest 内部不一致（服务器版本 0.9.1 与包版本 0.8.1），Tests 徽章又指向名称不同的仓库（elevenlabs/elevenlabs-mcp-server）。按静态规则，缺少可验证执行证据时可靠性上限为 12，版本矛盾和证据缺失使其降至 10。
安全与权限 14/20: 凭证通过必需的秘密环境变量 ELEVENLABS_API_KEY 处理，安装示例使用占位符而非真实令牌，未发现恶意、窃取凭证或隐蔽外传的红线问题。基础路径 ELEVENLABS_MCP_BASE_PATH 同时充当输入文件沙箱，越界路径会被拒绝，数据边界披露清晰；输出模式（files/resources/both）和磁盘副作用有说明，README 还明确警告工具会消耗 ElevenLabs 额度。扣分项：耗额操作没有逐次确认机制，未说明 API 密钥的最小权限范围，默认写入位置为 ~/Desktop 范围偏宽，数据驻留标注为企业版专属且未提供留存/共享细节。
维护活跃度 13/20: 仓库未归档、采用 MIT 许可证、归属明确（官方 ElevenLabs）、PyPI 上有包版本号，未关闭问题仅 8 个，manifest 声明状态为 active，README 附有 Discord 社区与贡献指南。扣分项：所供材料中没有提交/发布历史、变更日志或依赖更新证据，没有 SECURITY.md 或安全响应渠道，且 manifest 版本（0.9.1）与包版本（0.8.1）不一致属于版本治理缺口。星标数仅作发现信号，未参与计分。
文档质量 15/20: README 分层较好：Claude Desktop 快速开始并附现成 JSON 配置、其他客户端的 pip/python 备选流程、示例提示词、三种输出模式及配置示例与资源模式优势、数据驻留说明、贡献步骤，以及含各系统日志路径、超时和 uvx ENOENT 解决方案的故障排查章节。成本（需要额度）、耗时操作和 Windows 开发者模式等限制均已披露。扣分项：所给材料未包含逐工具的完整参数参考，未覆盖速率限制，Tests 徽章指向名称不同的仓库，故障排查仅两条且未涉及上游 API 错误。
安装易用性 14/20: 安装路径简短具体：安装 uv 后，将含占位符密钥的 JSON 配置粘贴到 Claude Desktop，或为 Cursor/Windsurf 等客户端执行 pip install 与 python -m elevenlabs_mcp --api-key ... --print 获取配置。前置条件（uv、API 密钥、免费额度）和 Windows 专属说明均已提供。按静态规则，缺少可验证执行证据时安装上限为 15；文档中记录的 uvx ENOENT 故障、其他客户端需手动复制配置、Windows 需要开发者模式，以及无 Docker 等替代部署方式，使其低于上限。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络

适合谁

开发者和团队希望为他们的应用集成文本转语音或音频处理能力的场景
使用 MCP 客户端（如 Claude Desktop）来生成高质量语音和音频文件的用户

不适合谁

不需要音频处理功能的用户
希望使用其他 TTS 服务的用户
需要实时流式音频输出的场景（该 MCP 可能不支持）

所需权限

需要 ElevenLabs API 密钥（必需）
需要读写文件系统（默认在桌面目录，可通过 ELEVENLABS_MCP_BASE_PATH 配置）
可选的 ELEVENLABS_MCP_OUTPUT_MODE 环境变量用于控制输出模式（文件或资源）

风险与副作用

使用 ElevenLabs API 会消耗积分，免费层有限额，需注意用量
API 密钥如果泄露可能导致账号被盗用，应妥善保管
音频文件可能包含敏感信息，需注意数据隐私
某些操作（如音频隔离）可能耗时较长，导致客户端超时

安装接入

准备工作

运行环境：Python · 预编译二进制

ELEVENLABS_API_KEY 必填密钥 ElevenLabs API 密钥，必需；在 elevenlabs.io/app/settings/api-keys 获取，有每月1万积分的免费额度。

其他可选配置项（3 个）

ELEVENLABS_MCP_BASE_PATH 可选可选；文件读写的基础目录（默认 $HOME/Desktop），也是读取本地文件的安全边界。

ELEVENLABS_API_RESIDENCY 可选可选；数据驻留区域，默认 'us'，属企业版功能。

ELEVENLABS_MCP_OUTPUT_MODE 可选可选；输出模式，默认 'files'，可选 'resources' 或 'both'。

从 ElevenLabs 获取 API 密钥（免费层提供每月 10k 积分）。
安装 uv（Python 包管理器）：curl -LsSf https://astral.sh/uv/install.sh | sh
在 Claude Desktop 的配置文件（claude_desktop_config.json）中添加 MCP 服务器配置，包含命令 uvx、参数 ["elevenlabs-mcp"]，并设置环境变量 ELEVENLABS_API_KEY。

验证是否装好

在 Claude Desktop 设置中将 ElevenLabs 服务器加入 mcpServers 并填入 ELEVENLABS_API_KEY，重启后询问“生成一段雷暴雨林的音景”，若能返回音频文件或资源即说明安装成功。

常见排障

确保 ELEVENLABS_API_KEY 已正确设置
如果遇到 'spawn uvx ENOENT' 错误，请检查 uvx 的绝对路径并更新配置
查看日志文件：Windows: %APPDATA%\Claude\logs\mcp-server-elevenlabs.log；macOS: ~/Library/Logs/Claude/mcp-server-elevenlabs.log
确保文件路径在 ELEVENLABS_MCP_BASE_PATH 目录内，否则可能被拒绝

试试这样问

连接成功后，可以直接对 AI 助手这样说：

创建一个像黑色电影侦探一样说话、能回答经典电影问题的AI语音代理
为一个睿智的远古巨龙角色生成三个声音变体，供我挑选加入声音库
把这段我录制的语音转换成像中世纪骑士一样的声音
生成一段密集丛林中雷暴风雨、动物对天气作出反应的音景

使用场景

生成语音（文本转语音）

克隆声音（创建声音副本）

语音代理（创建交互式语音代理）

音频转录（语音转文字）

音频转换（如语音转语音、视频转音乐）

音频隔离（分离人声和音乐）

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

由 ElevenLabs 官方维护的 MCP 服务器，支持文本转语音、语音克隆、语音代理、音频转录和音频隔离等功能。它允许 MCP 客户端（如 Claude Desktop、Cursor、Windsurf）与 ElevenLabs API 交互，生成语音、克隆声音、转录音频等。