AI导哈

文本转语音服务器

一个集成ElevenLabs文本转语音API的模型上下文协议服务器，提供服务器组件和基于Web的MCP客户端，用于管理语音生成任务。

  • by Muna1971
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Muna1971/elevenlabs-mcp-server

使用说明

ElevenLabs MCP 服务器

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

特点/特性

  • 使用ElevenLabs API根据文本生成音频
  • 支持多音轨和剧本部分
  • 用于持久化历史存储的SQLite数据库
  • 针对（某项目/场景）的SvelteKit MCP客户端示例
    • 简单的文本转语音转换
    • 多部分脚本管理
    • 语音历史记录追踪与回放
    • 音频文件下载

安装

通过Smithery进行安装

通过自动方式为Claude桌面安装ElevenLabs MCP服务器 Smithery 可以翻译为“铁匠铺”或“锻造工坊”:

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

使用uvx（推荐）

在使用时 uvx无需特定的安装。

在您的MCP设置文件中添加以下配置（例如。， cline_mcp_settings.json （适用于 Claude Desktop）：

{
  "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 to .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用户界面目录：
    cd clients/web-ui
  2. 安装依赖项：
    pnpm install
  3. 复制 .env.example 到 .env 并根据需要进行配置
  4. 运行网页用户界面：
    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许可证授权——详见 许可证 详情见文件。

相关 MCP