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。