ElevenLabs MCP Server

ElevenLabs MCP Server

site icon
2025.01.08 73
Python文本转语音语音生成音频内容生成内容生成
ElevenLabs MCP Server 是一个集成了 ElevenLabs 文本转语音 API 的 Model Context Protocol (MCP) 服务器。它提供了一个服务器组件和一个基于 Web 的 MCP 客户端示例(使用 SvelteKit 构建),用于管理语音生成任务。该服务器支持多种语音和脚本部分,并使用 SQLite 数据库进行持久化历史存储。
View on GitHub

Overview

基本能力

产品定位

ElevenLabs MCP Server 是一个专注于文本转语音(TTS)的服务,通过集成 ElevenLabs API 提供高质量的语音生成功能。

核心功能

  • 使用 ElevenLabs API 从文本生成音频
  • 支持多种语音和脚本部分
  • 使用 SQLite 数据库进行持久化历史存储
  • 提供示例 SvelteKit MCP 客户端,支持:
  • 简单的文本转语音转换
  • 多部分脚本管理
  • 语音历史跟踪和回放
  • 音频文件下载

适用场景

  • 需要高质量文本转语音的应用
  • 多语音角色的音频内容生成
  • 语音历史管理和回放

工具列表

  • generate_audio_simple: 使用默认语音设置从纯文本生成音频
  • generate_audio_script: 从结构化脚本生成音频,支持多种语音和演员
  • delete_job: 按 ID 删除任务
  • get_audio_file: 按 ID 获取音频文件
  • list_voices: 列出所有可用语音
  • get_voiceover_history: 获取语音任务历史,可选指定任务 ID

常见问题解答

文档中未提供具体常见问题解答。

使用教程

使用依赖

需要安装 ElevenLabs API 密钥和配置相关环境变量。

安装教程

通过 Smithery 安装

npx -y @smithery/cli install elevenlabs-mcp-server --client claude

使用 uvx(推荐)

无需特定安装,只需在 MCP 设置文件中添加配置。

开发安装

  1. 克隆仓库
  2. 安装依赖: bash uv venv
  3. 复制 .env.example.env 并填写 ElevenLabs 凭证

调试方式

使用示例 SvelteKit MCP 客户端

  1. 进入 web UI 目录: bash cd clients/web-ui
  2. 安装依赖: bash pnpm install
  3. 复制 .env.example.env 并配置
  4. 运行 web UI: bash pnpm dev
  5. 在浏览器中打开 http://localhost:5174

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。