1. 服务概述一句话简介为Claude Desktop、Cursor和Windsurf等MCP客户端提供强大的音频和AI功能服务名称ElevenLabs MCP Server版本号最新版本开发者/提供方ElevenLabs协议类型MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点文本转语音TTS将文本转换为语音支持自定义声音、稳定性、速度和风格语音转文本STT转录音频支持可选的说话人分离语音功能从音频文件克隆声音、在声音之间转换语音、设计和预览新声音音频处理从文本生成音效、隔离音频、播放WAV/MP3文件语音库管理搜索、预览和管理个人和共享库中的声音对话AI创建和管理具有特定声音和知识库的代理通信功能通过Twilio进行外呼通话并管理相关电话号码账户管理监控API使用情况和订阅状态3. 使用场景描述该服务适合在什么情况下使用AI代理创建创建具有特定声音和知识库的AI代理语音变体生成为角色生成多个语音变体供选择语音转换将录音转换为不同的声音风格音效创作从文本描述创建复杂的音效和声音景观多说话人转录识别不同说话人并转换为独特声音内容创作为视频、播客和音频内容生成专业配音无障碍应用为视障用户提供文本转语音服务4. 接入方式4.1 服务端点安装方式Python包通过uvx或pip安装命令行工具uvx elevenlabs-mcpPython模块python -m elevenlabs_mcp4.2 认证与权限API密钥认证从ElevenLabs官网获取API密钥免费层每月提供10,000个积分支持数据驻留密钥企业功能通过环境变量ELEVENLABS_API_KEY配置数据驻留配置使用ELEVENLABS_API_RESIDENCY环境变量指定数据驻留区域默认值为us仅企业版支持数据驻留功能4.3 数据格式请求和响应格式协议MCP (Model Context Protocol)音频格式WAV、MP3文本编码UTF-8数据返回文件路径或base64编码资源4.4 服务器配置在Claude Desktop配置中添加服务{ mcpServers: { ElevenLabs: { command: uvx, args: [elevenlabs-mcp], env: { ELEVENLABS_API_KEY: } } } }5. 接口定义5.1 核心工具工具类别功能描述操作类型文本转语音将文本转换为语音支持自定义声音、稳定性、速度和风格生成语音转文本转录音频支持可选的说话人分离识别声音克隆从音频文件克隆声音创建语音转换在声音之间转换语音转换声音设计设计和预览新声音创建音效生成从文本生成音效生成音频隔离隔离音频中的特定声音处理语音库管理搜索、预览和管理声音库管理代理管理创建和管理具有特定声音和知识库的AI代理管理外呼通话通过Twilio进行外呼通话通信6. 快速开始6.1 环境要求Python版本Python 3.8或更高版本包管理器uv推荐或pipAPI密钥ElevenLabs API密钥MCP客户端Claude Desktop、Cursor或Windsurf积分ElevenLabs账户积分免费层每月10k积分6.2 示例代码使用Claude Desktop配置{ mcpServers: { ElevenLabs: { command: uvx, args: [elevenlabs-mcp], env: { ELEVENLABS_API_KEY: your-api-key-here } } } }使用pip安装pip install elevenlabs-mcp python -m elevenlabs_mcp --api-keyyour-api-key --print配置文件输出模式{ mcpServers: { ElevenLabs: { command: uvx, args: [elevenlabs-mcp], env: { ELEVENLABS_API_KEY: your-api-key, ELEVENLABS_MCP_BASE_PATH: ~/Desktop, ELEVENLABS_MCP_OUTPUT_MODE: files } } } }示例使用场景创建一个像黑色电影侦探一样说话的AI代理可以回答关于经典电影的问题为智慧古老的龙角色生成三种语音变体然后我会选择最喜欢的声音添加到我的语音库将我的声音录音转换为中世纪骑士的声音创建一个密集丛林中雷暴的音景动物对天气做出反应将这段语音转换为文本识别不同的说话人然后使用独特的声音转换回来7. 注意事项重要提醒积分需求使用这些工具需要ElevenLabs积分免费层限制免费层每月提供10,000个积分超时问题某些操作如声音设计和音频隔离可能需要较长时间完成Windows用户需要在Claude Desktop中启用开发者模式文件输出配置ELEVENLABS_MCP_BASE_PATH指定文件操作的基础路径默认~/DesktopELEVENLABS_MCP_OUTPUT_MODE控制生成文件的返回方式默认filesfiles保存文件到磁盘并返回文件路径resources将文件作为MCP资源返回base64编码both保存文件到磁盘并作为MCP资源返回故障排除日志位置Windows%APPDATA%\Claude\logs\mcp-server-elevenlabs.logmacOS~/Library/Logs/Claude/mcp-server-elevenlabs.loguvx ENOENT错误使用which uvx获取绝对路径在配置中使用完整路径超时错误某些API操作可能需要较长时间但在Claude等客户端中不应出现超时最佳实践监控API使用情况以避免超出积分限制使用适当的声音设置以获得最佳音频质量在生产环境中考虑使用数据驻留功能企业版定期检查账户订阅状态 
长河君 · 2026/10/28 21:17:41 · 阅读 1.2k ElevenLabs MCP Server MCP 服务说明文档
1. 服务概述一句话简介为Claude Desktop、Cursor和Windsurf等MCP客户端提供强大的音频和AI功能服务名称ElevenLabs MCP Server版本号最新版本开发者/提供方ElevenLabs协议类型MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点文本转语音TTS将文本转换为语音支持自定义声音、稳定性、速度和风格语音转文本STT转录音频支持可选的说话人分离语音功能从音频文件克隆声音、在声音之间转换语音、设计和预览新声音音频处理从文本生成音效、隔离音频、播放WAV/MP3文件语音库管理搜索、预览和管理个人和共享库中的声音对话AI创建和管理具有特定声音和知识库的代理通信功能通过Twilio进行外呼通话并管理相关电话号码账户管理监控API使用情况和订阅状态3. 使用场景描述该服务适合在什么情况下使用AI代理创建创建具有特定声音和知识库的AI代理语音变体生成为角色生成多个语音变体供选择语音转换将录音转换为不同的声音风格音效创作从文本描述创建复杂的音效和声音景观多说话人转录识别不同说话人并转换为独特声音内容创作为视频、播客和音频内容生成专业配音无障碍应用为视障用户提供文本转语音服务4. 接入方式4.1 服务端点安装方式Python包通过uvx或pip安装命令行工具uvx elevenlabs-mcpPython模块python -m elevenlabs_mcp4.2 认证与权限API密钥认证从ElevenLabs官网获取API密钥免费层每月提供10,000个积分支持数据驻留密钥企业功能通过环境变量ELEVENLABS_API_KEY配置数据驻留配置使用ELEVENLABS_API_RESIDENCY环境变量指定数据驻留区域默认值为us仅企业版支持数据驻留功能4.3 数据格式请求和响应格式协议MCP (Model Context Protocol)音频格式WAV、MP3文本编码UTF-8数据返回文件路径或base64编码资源4.4 服务器配置在Claude Desktop配置中添加服务{ mcpServers: { ElevenLabs: { command: uvx, args: [elevenlabs-mcp], env: { ELEVENLABS_API_KEY: } } } }5. 接口定义5.1 核心工具工具类别功能描述操作类型文本转语音将文本转换为语音支持自定义声音、稳定性、速度和风格生成语音转文本转录音频支持可选的说话人分离识别声音克隆从音频文件克隆声音创建语音转换在声音之间转换语音转换声音设计设计和预览新声音创建音效生成从文本生成音效生成音频隔离隔离音频中的特定声音处理语音库管理搜索、预览和管理声音库管理代理管理创建和管理具有特定声音和知识库的AI代理管理外呼通话通过Twilio进行外呼通话通信6. 快速开始6.1 环境要求Python版本Python 3.8或更高版本包管理器uv推荐或pipAPI密钥ElevenLabs API密钥MCP客户端Claude Desktop、Cursor或Windsurf积分ElevenLabs账户积分免费层每月10k积分6.2 示例代码使用Claude Desktop配置{ mcpServers: { ElevenLabs: { command: uvx, args: [elevenlabs-mcp], env: { ELEVENLABS_API_KEY: your-api-key-here } } } }使用pip安装pip install elevenlabs-mcp python -m elevenlabs_mcp --api-keyyour-api-key --print配置文件输出模式{ mcpServers: { ElevenLabs: { command: uvx, args: [elevenlabs-mcp], env: { ELEVENLABS_API_KEY: your-api-key, ELEVENLABS_MCP_BASE_PATH: ~/Desktop, ELEVENLABS_MCP_OUTPUT_MODE: files } } } }示例使用场景创建一个像黑色电影侦探一样说话的AI代理可以回答关于经典电影的问题为智慧古老的龙角色生成三种语音变体然后我会选择最喜欢的声音添加到我的语音库将我的声音录音转换为中世纪骑士的声音创建一个密集丛林中雷暴的音景动物对天气做出反应将这段语音转换为文本识别不同的说话人然后使用独特的声音转换回来7. 注意事项重要提醒积分需求使用这些工具需要ElevenLabs积分免费层限制免费层每月提供10,000个积分超时问题某些操作如声音设计和音频隔离可能需要较长时间完成Windows用户需要在Claude Desktop中启用开发者模式文件输出配置ELEVENLABS_MCP_BASE_PATH指定文件操作的基础路径默认~/DesktopELEVENLABS_MCP_OUTPUT_MODE控制生成文件的返回方式默认filesfiles保存文件到磁盘并返回文件路径resources将文件作为MCP资源返回base64编码both保存文件到磁盘并作为MCP资源返回故障排除日志位置Windows%APPDATA%\Claude\logs\mcp-server-elevenlabs.logmacOS~/Library/Logs/Claude/mcp-server-elevenlabs.loguvx ENOENT错误使用which uvx获取绝对路径在配置中使用完整路径超时错误某些API操作可能需要较长时间但在Claude等客户端中不应出现超时最佳实践监控API使用情况以避免超出积分限制使用适当的声音设置以获得最佳音频质量在生产环境中考虑使用数据驻留功能企业版定期检查账户订阅状态