MCP 服务器

ElevenLabs MCP Server

与 ElevenLabs 文本转语音 API 集成。

语音处理

访问服务器

Tools

generate_audio_simple

Generate audio from plain text using default voice settings

generate_audio_script

Generate audio from a structured script with multiple voices and actors. Accepts either: 1. Plain text string 2. JSON string with format: { "script": [ { "text": "Text to speak", "voice_id": "optional-voice-id", "actor": "optional-actor-name" }, ... ] }

delete_job

Delete a voiceover job and its associated files

get_audio_file

Get the audio file content for a specific job

list_voices

Get a list of all available ElevenLabs voices with metadata

get_voiceover_history

Get voiceover job history. Optionally specify a job ID for a specific job.

README

ElevenLabs MCP 服务器

一个与 ElevenLabs 文本转语音 API 集成的模型上下文协议 (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"
      }
    }
  }
}

开发安装

克隆此存储库
安装依赖项：
```
uv venv
```
将 .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"
      }
    }
  }
}