ElevenLabs

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

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

1. Получите API-ключ на ElevenLabs. Доступен бесплатный тариф с 10 тыс. кредитов в месяц.
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, для работы с MCP-сервером необходимо включить «Режим разработчика» в Claude Desktop. Нажмите «Справка» в меню-гамбургере в левом верхнем углу и выберите «Включить режим разработчика».

Другие 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)
• 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"). Это гарантирует, что будет использоваться правильный исполняемый файл.