Elevenlabs MCP

🚀 快速上手指南（Claude Desktop）

本指南將幫助您快速上手使用 Claude Desktop 並集成 ElevenLabs 的 API 服務，讓您能夠順利使用相關功能。

🚀 快速開始

1. 獲取 API 密鑰

從 ElevenLabs 獲取您的 API 密鑰。免費層提供每月 10,000 信用額度。

2. 安裝 uv

安裝 uv（Python 包管理器），使用以下命令：

curl -LsSf https://astral.sh/uv/install.sh | sh

或參考 uv 倉庫 獲取其他安裝方法。

3. 配置 Claude Desktop

打開 Claude > 設置 > 開發者 > 編輯配置 > claude_desktop_config.json，添加以下內容：

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "<在此處插入您的API密鑰>"
      }
    }
  }
}

⚠️ 重要提示

如果您使用的是 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 使用了。

💻 使用示例

日誌文件路徑

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

某些工具的超時問題

使用 ElevenLabs 的某些 API 操作（例如語音設計和音頻隔離）可能會花費較長時間。在使用 MCP 工具檢查器進行開發模式時，您可能會遇到超時錯誤，儘管工具已經完成其預期任務。

💡 使用建議

在使用客戶端如 Claude 時，這種情況不會發生。

MCP ElevenLabs: spawn uvx ENOENT 錯誤

如果遇到錯誤“MCP ElevenLabs: spawn uvx ENOENT”，請確認其絕對路徑。運行以下命令：

which uvx

獲得絕對路徑後（例如 /usr/local/bin/uvx），更新您的配置以使用該路徑（例如 "command": "/usr/local/bin/uvx"）。這樣可以確保引用正確的可執行文件。

🤝 貢獻方式

1. 複製 .env.example 到 .env 並添加您的 ElevenLabs API 密鑰：

cp .env.example .env
# 編輯 .env 文件並添加您的 API 密鑰

2. 運行測試以確保一切正常工作：

./scripts/test.sh
# 或使用選項
./scripts/test.sh --verbose --fail-fast

3. 在 Claude Desktop 中安裝服務器：mcp install elevenlabs_mcp/server.py
4. 使用 MCP 檢查器本地調試和測試：mcp dev elevenlabs_mcp/server.py

🛠️ 故障排除

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