ElevenLabs

[!WARNING] 此本機 MCP 伺服器已棄用，改由 ElevenLabs 託管 MCP 伺服器 取代。

託管伺服器位於 https://api.elevenlabs.io/v1/mcp，無需在本機安裝或執行任何內容。它使用 OAuth 進行驗證，因此不會將 API 金鑰複製到您的用戶端。請參閱託管 MCP 伺服器文件，以從 Claude、Cursor 或任何其他 MCP 用戶端連線。

此儲存庫已不再積極維護。

官方 ElevenLabs Model Context Protocol (MCP) 伺服器，可與強大的文字轉語音和音訊處理 API 進行互動。此伺服器允許 MCP 用戶端（如 Claude Desktop、Cursor、Windsurf、OpenAI Agents 等）生成語音、複製聲音、轉錄音訊等。

使用 Claude Desktop 快速入門

1. 從 ElevenLabs 取得您的 API 金鑰。免費方案每月提供 10,000 點額度。
2. 安裝 uv（Python 套件管理器），使用 curl -LsSf https://astral.sh/uv/install.sh | sh 安裝，或參閱 uv 儲存庫 以了解其他安裝方式。
3. 前往 Claude > 設定 > 開發人員 > 編輯設定 > claude_desktop_config.json，並加入以下內容：

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

如果您使用 Windows，則必須在 Claude Desktop 中啟用「開發人員模式」才能使用 MCP 伺服器。點擊左上角漢堡選單中的「說明」，然後選取「啟用開發人員模式」。

其他 MCP 用戶端

對於其他用戶端（如 Cursor 和 Windsurf），請執行：

1. pip install elevenlabs-mcp
2. python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print 以取得設定。將其貼到 MCP 用戶端指定的相應設定目錄中。

就是這樣。您的 MCP 用戶端現在可以透過以下工具與 ElevenLabs 互動：

使用範例

⚠️ 警告：使用這些工具需要 ElevenLabs 點數。

試著詢問 Claude：

• 「建立一個說話像黑色電影偵探的 AI 代理，並且能回答經典電影相關問題」
• 「為一個睿智的遠古巨龍角色生成三種聲音變體，然後我會選擇最喜歡的聲音加入我的聲音庫」
• 「將我的聲音錄音轉換成聽起來像中世紀騎士」
• 「建立一個茂密叢林中雷暴的音景，並有動物對天氣做出反應」
• 「將這段語音轉成文字，識別不同的說話者，然後為每個人使用獨特聲音轉回語音」

選用功能

檔案輸出設定

您可以使用 claude_desktop_config.json 中的這些環境變數來設定 MCP 伺服器處理檔案輸出的方式：

• ELEVENLABS_MCP_BASE_PATH：指定檔案作業的基礎路徑（預設：~/Desktop）。此目錄也是輸入檔案的安全邊界：傳遞給讀取本機檔案之工具（例如 speech_to_text、isolate_audio、speech_to_speech、video_to_music、upload_music_for_inpainting）的任何路徑，無論是絕對路徑或相對路徑，都必須解析到此目錄內。此目錄之外的路徑——即使是絕對路徑且先前曾被接受——都會被拒絕。請將此設定為包含您需要讀取或寫入之所有內容的目錄。
• ELEVENLABS_MCP_OUTPUT_MODE：控制生成檔案的傳回方式（預設：files）

輸出模式

ELEVENLABS_MCP_OUTPUT_MODE 環境變數支援三種模式：

1. files（預設）：將檔案儲存到磁碟並傳回檔案路徑

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "files"
   }
   

2. resources：將檔案作為 MCP 資源傳回；二進位資料以 base64 編碼，文字以 UTF-8 文字傳回

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "resources"
   }
   

3. both：將檔案儲存到磁碟並作為 MCP 資源傳回

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "both"
   }
   

資源模式優點：

• 檔案以 base64 編碼資料直接傳回在 MCP 回應中
• 無需磁碟 I/O——適用於容器化或無伺服器環境
• MCP 用戶端可以立即存取檔案內容，無需檔案系統存取
• 在 both 模式下，之後可以使用 elevenlabs://filename URI 模式擷取資源

使用案例：

• files：傳統檔案型工作流程、本機開發
• resources：雲端環境、無檔案系統存取的 MCP 用戶端
• both：最大靈活性、快取和資源共享情境

資料駐留金鑰

您可以使用 ELEVENLABS_API_RESIDENCY 環境變數指定資料駐留區域。預設為 "us"。

注意： 資料駐留僅限企業版功能。請參閱文件以了解更多詳細資訊。

貢獻

如果您想貢獻或從原始碼執行：

1. 複製儲存庫：

git clone https://github.com/elevenlabs/elevenlabs-mcp
cd elevenlabs-mcp

2. 建立虛擬環境並使用 uv 安裝相依套件：

uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

3. 將 .env.example 複製到 .env，並加入您的 ElevenLabs API 金鑰：

cp .env.example .env
# Edit .env and add your API key

4. 執行測試以確保一切正常運作：

./scripts/test.sh
# Or with options
./scripts/test.sh --verbose --fail-fast

5. 在 Claude Desktop 中安裝伺服器：mcp install elevenlabs_mcp/server.py

6. 使用 MCP Inspector 進行本機除錯和測試：mcp dev elevenlabs_mcp/server.py

疑難排解

使用 Claude Desktop 執行時的日誌可在以下位置找到：

• Windows：%APPDATA%\Claude\logs\mcp-server-elevenlabs.log
• macOS：~/Library/Logs/Claude/mcp-server-elevenlabs.log

使用某些工具時逾時

某些 ElevenLabs API 操作（如聲音設計和音訊隔離）可能需要較長時間才能完成。在開發模式下使用 MCP inspector 時，即使工具已完成其預期任務，您仍可能遇到逾時錯誤。

使用 Claude 等用戶端時不應發生此情況。

MCP ElevenLabs：spawn uvx ENOENT

如果您遇到「MCP ElevenLabs: spawn uvx ENOENT」錯誤，請在終端機中執行以下命令來確認其絕對路徑：

which uvx

取得絕對路徑後（例如 /usr/local/bin/uvx），更新您的設定以使用該路徑（例如 "command": "/usr/local/bin/uvx"）。這可確保參照到正確的可執行檔。