ElevenLabs MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables text-to-speech audio generation using ElevenLabs' API, supporting multiple voices, script parts with different speakers, audio file management, and voice history tracking.

  • Provides persistent storage for voice generation history, allowing retrieval and management of past text-to-speech jobs.

  • Includes a sample SvelteKit MCP Client for text-to-speech conversion, multi-part script management, and audio file playback and downloads.

ElevenLabs MCP 服务器

与 ElevenLabs 文本转语音 API 集成的模型上下文协议 (MCP) 服务器,具有服务器组件和用于管理语音生成任务的基于 Web 的示例 MCP 客户端 (SvelteKit)。

特征

  • 使用 ElevenLabs API 从文本生成音频
  • 支持多种声音和脚本部分
  • 用于持久历史记录存储的 SQLite 数据库
  • 示例 SvelteKit MCP 客户端:
    • 简单的文本到语音转换
    • 多部分脚本管理
    • 语音历史追踪与回放
    • 音频文件下载

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 ElevenLabs MCP 服务器:

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

使用 uvx(推荐)

使用uvx时,不需要进行特殊安装。

将以下配置添加到您的 MCP 设置文件(例如,Claude Desktop 的cline_mcp_settings.json ):

{ "mcpServers": { "elevenlabs": { "command": "uvx", "args": ["elevenlabs-mcp-server"], "env": { "ELEVENLABS_API_KEY": "your-api-key", "ELEVENLABS_VOICE_ID": "your-voice-id", "ELEVENLABS_MODEL_ID": "eleven_flash_v2", "ELEVENLABS_STABILITY": "0.5", "ELEVENLABS_SIMILARITY_BOOST": "0.75", "ELEVENLABS_STYLE": "0.1", "ELEVENLABS_OUTPUT_DIR": "output" } } } }

开发安装

  1. 克隆此存储库
  2. 安装依赖项:
    uv venv
  3. .env.example复制到.env并填写您的 ElevenLabs 凭证
{ "mcpServers": { "elevenlabs": { "command": "uv", "args": [ "--directory", "path/to/elevenlabs-mcp-server", "run", "elevenlabs-mcp-server" ], "env": { "ELEVENLABS_API_KEY": "your-api-key", "ELEVENLABS_VOICE_ID": "your-voice-id", "ELEVENLABS_MODEL_ID": "eleven_flash_v2", "ELEVENLABS_STABILITY": "0.5", "ELEVENLABS_SIMILARITY_BOOST": "0.75", "ELEVENLABS_STYLE": "0.1", "ELEVENLABS_OUTPUT_DIR": "output" } } } }

使用示例 SvelteKit MCP 客户端

  1. 导航到 Web UI 目录:
    cd clients/web-ui
  2. 安装依赖项:
    pnpm install
  3. .env.example复制到.env并根据需要进行配置
  4. 运行 Web UI:
    pnpm dev
  5. 在浏览器中打开http://localhost:5174

可用工具

  • generate_audio_simple :使用默认语音设置从纯文本生成音频
  • generate_audio_script :从具有多个声音和演员的结构化脚本生成音频
  • delete_job :通过 ID 删除作业
  • get_audio_file :通过 ID 获取音频文件
  • list_voices :列出所有可用的声音
  • get_voiceover_history :获取配音任务历史记录。(可选)指定特定任务的任务 ID。

可用资源

  • voiceover://history/{job_id} :通过 ID 获取音频文件
  • voiceover://voices :列出所有可用的声音

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅LICENSE文件。

ID: leukzvus7o