Elevenlabs MCP Server

🚀 ElevenLabs MCP 服务器

一个集成 ElevenLabs 文本转语音 API 的模型上下文协议 (MCP) 服务器，它包含服务器组件以及一个基于 SvelteKit 的示例 MCP 客户端，可用于管理语音生成任务。

🚀 快速开始

你可以通过以下步骤快速使用本服务器，详细安装方式见后续内容。先完成安装，再使用基于 SvelteKit 的 MCP 客户端进行语音生成任务管理。

✨ 主要特性

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

📦 安装指南

通过 Smithery 安装

可自动使用 Smithery 在 Claude Desktop 上安装 ElevenLabs MCP Server：

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", // 替换为你的 API 密钥
        "ELEVENLABS_VOICE_ID": "your-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": "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. 进入目录：

   cd your-project-directory
   

2. 安装依赖：

   npm install
   

3. 配置环境变量并启动服务。

工具

• text-to-speech：将文本转换为语音。
• script-manager：管理多个脚本部分。

资源

• URL 模式：
  • http://localhost:5000/text-to-speech
  • http://localhost:5000/script-manager

📄 许可证

本项目采用 MIT License。