mamertofabian_elevenlabs-mcp-server

🚀 ElevenLabs MCP 服务器

ElevenLabs MCP 服务器结合了 ElevenLabs 文本转语音 API，采用模型上下文协议（MCP）。它包含一个服务器组件和一个基于网络的示例 MCP 客户端（使用 SvelteKit），可高效管理语音生成任务。

🚀 快速开始

ElevenLabs MCP 服务器能借助 ElevenLabs API 把文本转化为音频，还支持多声音和脚本部分，同时利用 SQLite 数据库存储历史记录。示例 SvelteKit MCP 客户端则提供了简单易用的文本转语音转换、多部分脚本管理、语音历史跟踪和播放以及音频文件下载等功能。

✨ 主要特性

• 运用 ElevenLabs API 实现文本到音频的转换。
• 支持多种声音和脚本部分。
• 利用 SQLite 数据库存储历史记录。
• 示例 SvelteKit MCP 客户端具备以下功能：
  • 便捷的文本转语音转换。
  • 有效的多部分脚本管理。
  • 精准的语音历史跟踪与播放。
  • 方便的音频文件下载。

📦 安装指南

使用 uvx（推荐）

若使用 uvx，则无需进行特殊安装。在 MCP 设置文件（如 Claude Desktop 的 cline_mcp_settings.json）中添加以下配置：

{
  "mcpServers": {
    "elevenlabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp-server"],
      "env": {
        "ELEVENLABS_API_KEY": "你的 API 密钥",
        "ELEVENLABS_VOICE_ID": "你的声音 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": "你的 API 密钥",
        "ELEVENLABS_VOICE_ID": "你的声音 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

可用工具

• 文本转语音：将输入的文本转换为语音。
• 语音播放：对生成的语音文件进行播放操作。
• 历史记录：查看之前语音生成的相关记录。
• 清除记录：清空历史记录。

资源

• voiceover://history/{job_id}：可访问特定任务的历史记录。
• voiceover://output/{filename}：用于访问生成的音频文件。
• voiceover://settings：可在此配置语音生成参数。

📄 许可证

本项目采用 MIT 许可证。