ElevenLabs

[!WARNING] Этот локальный MCP-сервер устарел в пользу хостируемого MCP-сервера ElevenLabs.

Хостируемый сервер доступен по адресу https://api.elevenlabs.io/v1/mcp, и для него ничего не нужно устанавливать или запускать локально. Он аутентифицируется через OAuth, поэтому API-ключи не копируются в ваш клиент. См. документацию хостируемого MCP-сервера, чтобы подключиться из Claude, Cursor или любого другого MCP-клиента.

Этот репозиторий больше не поддерживается активно.

Официальный MCP-сервер ElevenLabs Model Context Protocol (MCP), который обеспечивает взаимодействие с мощными API для синтеза речи и обработки аудио. Этот сервер позволяет MCP-клиентам, таким как Claude Desktop, Cursor, Windsurf, OpenAI Agents и другим, генерировать речь, клонировать голоса, транскрибировать аудио и многое другое.

Быстрый старт с Claude Desktop

1. Получите свой API-ключ на ElevenLabs. Существует бесплатный тариф с 10 000 кредитов в месяц.
2. Установите uv (менеджер пакетов Python), установите с помощью curl -LsSf https://astral.sh/uv/install.sh | sh или обратитесь к uv репозиторию за дополнительными способами установки.
3. Перейдите в Claude > Settings > Developer > Edit Config > claude_desktop_config.json и добавьте следующее:

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

Если вы используете Windows, вам потребуется включить «Developer Mode» в Claude Desktop, чтобы использовать MCP-сервер. Нажмите «Help» в гамбургер-меню в верхнем левом углу и выберите «Enable Developer Mode».

Другие 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:

• «Создай ИИ-агента, который говорит как детектив из нуара и может отвечать на вопросы о классических фильмах»
• «Сгенерируй три варианта голоса для мудрого древнего дракона, затем я выберу любимый голос и добавлю его в свою голосовую библиотеку»
• «Преобразуй эту запись моего голоса так, чтобы она звучала как средневековый рыцарь»
• «Создай звуковой ландшафт грозы в густых джунглях с животными, реагирующими на погоду»
• «Преобразуй эту речь в текст, определи разных говорящих, затем преобразуй её обратно, используя уникальные голоса для каждого человека»

Дополнительные функции

Конфигурация вывода файлов

Вы можете настроить, как MCP-сервер обрабатывает вывод файлов, используя следующие переменные окружения в вашем claude_desktop_config.json:

• 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"
   }
   

Преимущества режима ресурсов:

• Файлы возвращаются непосредственно в ответе MCP как данные в кодировке base64
• Не требуется операций ввода-вывода на диск — полезно для контейнерных или бессерверных сред
• MCP-клиенты могут получить доступ к содержимому файлов немедленно без доступа к файловой системе
• В режиме both ресурсы можно получить позже, используя шаблон URI elevenlabs://filename

Варианты использования:

• 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 и добавьте свой API-ключ ElevenLabs:

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

Тайм-ауты при использовании некоторых инструментов

Некоторые операции API ElevenLabs, такие как дизайн голоса и изоляция аудио, могут занимать много времени. При использовании MCP Inspector в режиме разработки вы можете получать ошибки тайм-аута, даже если инструмент завершил свою задачу.

Этого не должно происходить при использовании такого клиента, как Claude.

MCP ElevenLabs: spawn uvx ENOENT

Если вы столкнулись с ошибкой «MCP ElevenLabs: spawn uvx ENOENT», подтвердите её абсолютный путь, выполнив эту команду в терминале:

which uvx

После получения абсолютного пути (например, /usr/local/bin/uvx) обновите конфигурацию, чтобы использовать этот путь (например, "command": "/usr/local/bin/uvx"). Это гарантирует, что будет использоваться правильный исполняемый файл.