ElevenLabs MCP 服务器

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

功能特性

• 使用 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 许可证。