Mamertofabian Elevenlabs MCP Server

🚀 ElevenLabs MCP 服務器

ElevenLabs MCP 服務器是一個結合了 ElevenLabs 文本轉語音 API 的模型上下文協議 (MCP) 服務器。它包含一個服務器組件和一個基於網絡的示例 MCP 客戶端（使用 SvelteKit），可高效管理語音生成任務。

✨ 主要特性

• 音頻生成：藉助 ElevenLabs API 從文本生成音頻。
• 多聲音與腳本支持：支持多個聲音和腳本部分。
• 歷史記錄存儲：利用 SQLite 數據庫存儲歷史記錄。
• 示例客戶端功能豐富：示例 SvelteKit MCP 客戶端提供以下功能：
  • 簡單轉換：實現簡單的文本轉語音轉換。
  • 腳本管理：支持多部分腳本管理。
  • 歷史跟蹤與播放：可進行語音歷史跟蹤和播放。
  • 文件下載：支持音頻文件下載。

📦 安裝指南

🛠️ 使用 uvx（推薦）

當使用 uvx 時，無需進行特殊安裝。 在你的 MCP 設置文件中添加以下配置（例如：Claude Desktop 的 cline_mcp_settings.json）：

{
  "mcpServers": {
    "elevenlabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp-server"],
      "env": {
        "ELEVENLABS_API_KEY": "你的 API 密鑰",
        "ELEVENLABS_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": "你的 API 密鑰",
        "ELEVENLABS_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"
      }
    }
  }
}

💻 使用示例

🔍 使用示例 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

🛠️ 可用工具

• 文本轉語音：將文本轉換為語音。
• 語音播放：播放生成的語音文件。
• 歷史記錄：查看之前的語音生成記錄。
• 清除記錄：清空歷史記錄。

📚 資源

• voiceover://history/{job_id}：訪問特定任務的歷史記錄。
• voiceover://output/{filename}：訪問生成的音頻文件。
• voiceover://settings：配置語音生成參數。

📄 許可證

本項目使用 MIT 許可證。