ElevenLabs MCP Server

ElevenLabs MCP 服务

一个与 ElevenLabs 文本转语音 API 集成的 Model Context Protocol（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 文件。