ElevenLabs MCP Server

这是一个与ElevenLabs文本转语音API集成的模型上下文协议（MCP）服务器，包括一个服务器组件和一个用于管理语音生成任务的示例Web MCP客户端（SvelteKit）。

<a href="https://glama.ai/mcp/servers/leukzvus7o"><img width="380" height="200" src="https://gips3.baidu.com/it/u=4193593015,4015180507&fm=3081&app=3081&f=PNG?w=760&h=400" alt="ElevenLabs Server MCP服务器" /></a>

特性

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

安装

通过Smithery安装

要通过Smithery自动安装ElevenLabs MCP服务器到Claude桌面：

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

使用uvx（推荐）

当使用uvx时，不需要特定的安装步骤。

在您的MCP设置文件（例如Claude桌面的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文件。 </中文翻译>