elevenlabs-mcp

Быстрый старт с 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».

Related MCP server: ElevenLabs MCP Server

Другие 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 в режиме разработки вы можете получать ошибки тайм-аута, несмотря на то, что инструмент выполняет свою задачу.

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

MCP ElevenLabs: spawn uvx ENOENT

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

which uvx

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