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

特色

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

安装

通过Smithery安装

通过Smithery自动安装ElevenLabs MCP Server for Claude Desktop：

使用UVX（推荐）

使用uvx时，无需特定安装。

将以下配置添加到你的MCP设置文件中（例如，Claude Desktop的cline_mcp_settings.json）：

开发安装

1. 克隆此仓库

2. 安装依赖：

3. 将.env.example复制到.env，并填写你的ElevenLabs资质

使用示例 SvelteKit MCP 客户端

1. 导航到网页界面目录：

2. 安装依赖：

3. 将.env.example复制到.env，并根据需要配置

ElevenLabs MCP Server

A Model Context Protocol (MCP) server that integrates with ElevenLabs text-to-speech API, featuring both a server component and a sample web-based MCP Client (SvelteKit) for managing voice generation tasks.

Features

• Generate audio from text using ElevenLabs API
• Support for multiple voices and script parts
• SQLite database for persistent history storage
• Sample SvelteKit MCP Client for:
  • Simple text-to-speech conversion
  • Multi-part script management
  • Voice history tracking and playback
  • Audio file downloads

Installation

Installing via Smithery

To install ElevenLabs MCP Server for Claude Desktop automatically via Smithery:

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

Using uvx (recommended)

When using uvx, no specific installation is needed.

Add the following configuration to your MCP settings file (e.g., cline_mcp_settings.json for 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"
      }
    }
  }
}

Development Installation

1. Clone this repository
2. Install dependencies:

   uv venv
   

3. Copy .env.example to .env and fill in your ElevenLabs credentials

{
  "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"
      }
    }
  }
}

Using the Sample SvelteKit MCP Client

1. Navigate to the web UI directory:

   cd clients/web-ui
   

2. Install dependencies:

   pnpm install
   

3. Copy .env.example to .env and configure as needed
4. Run the web UI:

   pnpm dev
   

5. Open http://localhost:5174 in your browser

Available Tools

• generate_audio_simple: Generate audio from plain text using default voice settings