TwelveLabs MCP Server

Этот проект не связан с TwelveLabs (платформой для понимания видео). Это MCP-сервер для ElevenLabs Conversational AI API — голосовые агенты, базы знаний, разговоры и TTS. Название «TwelveLabs» — только кодовое имя проекта.

Расширенный MCP-сервер (Model Context Protocol), который предоставляет любому совместимому MCP-клиенту прямой доступ к ElevenLabs Conversational AI API — включая возможности, которые не раскрывает официальный коннектор ElevenLabs MCP.

Что это охватывает

• Агенты — список, получение полной конфигурации (включая модель LLM и температуру), обновление промпта/настроек, управление вебхуками и загрузкой файлов

• База знаний — список, чтение полного содержимого, добавление текстовых/URL-документов, удаление документов

• Разговоры — фильтрация и тегирование истории, просмотр транскриптов и повторный запуск анализа/оценок после звонка

• Голоса — список и поиск доступных голосов

Related MCP server: elevenlabs-mcp-experiments

Предварительные требования

• Node.js >= 18

• Ключ API ElevenLabs — получите его на elevenlabs.io

Быстрый старт

Вариант A: npx (клонирование не требуется)

ELEVENLABS_API_KEY=your-key npx twelvelabs-mcp-server

Вариант B: Клонирование и сборка

git clone https://github.com/micro-JAY/twelvelabs-mcp-server.git
cd twelvelabs-mcp-server
npm install --include=dev
npm run build

Подключение MCP-клиента

Добавьте эквивалентную запись сервера в конфигурацию вашего MCP-клиента. Расположение файла конфигурации и окружающий синтаксис зависят от клиента; ниже приведено стандартное определение сервера stdio:

{
  "mcpServers": {
    "twelvelabs": {
      "command": "node",
      "args": ["/path/to/twelvelabs-mcp-server/dist/index.js"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Перезапустите или переподключите ваш MCP-клиент. Вы должны увидеть twelvelabs в списке доступных инструментов.

Использование

Попросите вашего ассистента с поддержкой MCP использовать инструменты, например:

"Список моих агентов" "Получить полную конфигурацию для agent_1001kjbh14xce5kbreh55ydf4rae" "Показать последние 10 разговоров для этого агента" "Получить транскрипт и анализ для conversation_xyz"

Совместимость

Этот сервер работает с MCP-клиентами, которые поддерживают транспорт stdio и позволяют настраивать переменные окружения для локального серверного процесса. Клиентам, поддерживающим только удалённые HTTP MCP-серверы, требуется совместимый мост или прокси stdio.

Справочник инструментов

Инструменты агентов

Инструменты базы знаний

Инструменты разговоров

Инструменты голосов

Безопасность

• Проверка входных данных — все параметры инструментов проверяются с помощью схем Zod перед обращением к API

• Принудительное использование HTTPS — URL вебхуков проверяются на использование только HTTPS

• Защита от обхода пути — идентификаторы документов и агентов очищаются для предотвращения обхода пути

• Санитизация ошибок — внутренние ошибки перехватываются и возвращаются как безопасные ответы об ошибках MCP; необработанные трассировки стека никогда не раскрываются клиенту

Разработка

npm run dev   # watch mode with tsx -- auto-reloads on file changes
npm run build # compile to dist/

Участие в разработке

1. Сделайте форк репозитория

2. Создайте ветку функции (git checkout -b feat/my-feature)

3. Зафиксируйте изменения (git commit -m 'feat: add my feature')

4. Отправьте ветку (git push origin feat/my-feature)

5. Откройте Pull Request

Лицензия

MIT — подробности см. в LICENSE.

Примечание об архитектуре

Все инструменты используют единый экземпляр клиента Axios (src/client.ts), инициализируемый из ELEVENLABS_API_KEY при запуске. Реализации инструментов находятся в src/tools/ — по одному файлу на домен — и регистрируются на McpServer в src/index.ts. Сервер общается через транспорт stdio (stdin/stdout), поэтому вся отладочная запись использует console.error (stderr), а не console.log.