文本转语音服务器

ElevenLabs MCP Server是一个集成了ElevenLabs文本转语音API的服务器,提供语音生成任务管理和样本客户端功能。

  • by mamertofabian
  • Python
  • 本地部署
  • 119 星标
  • 更新于
在 GitHub 查看 mamertofabian/elevenlabs-mcp-server

使用说明

ElevenLabs MCP服务器

模型上下文协议(MCP)服务器,与ElevenLabs文本到速度API集成,具有服务器组件和用于管理语音生成任务的基于web的示例MCP客户端(SvelteKit)。

特性

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

安装

通过Smithery安装

通过以下方式自动安装ElevenLabs MCP Server for Claude Desktop 史密瑟里:

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

使用uvx(推荐)

使用时 uvx,不需要特定的安装。

将以下配置添加到MCP设置文件中(例如。, 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许可证获得许可-请参阅 许可证 文件以获取详细信息。