Twilio

официальный

Взаимодействуйте с API Twilio для отправки сообщений, управления номерами телефонов, настройки вашей учетной записи и многого другого.

GitHub
109

Что можно делать с Twilio MCP?

  • Отправка SMS и сообщений WhatsApp — Попросите своего ассистента составлять и отправлять сообщения через API обмена сообщениями Twilio.
  • Совершение и управление телефонными звонками — Инициируйте исходящие звонки, отслеживайте статус вызовов или изменяйте активные звонки через Twilio Voice API.
  • Поиск телефонных номеров — Получайте информацию об операторе и имени абонента для любого телефонного номера с помощью Twilio Lookup.
  • Покупка и настройка телефонных номеров — Ищите доступные номера и подключайте их в своей учетной записи через API телефонных номеров.
  • Фильтрация доступных API по сервису — Используйте флаги --services и --tags, чтобы ограничить, какие API Twilio доступны ассистенту, уменьшая размер контекста.

Документация

Twilio AlphaTwilio Alpha

Twilio MCP Монорепозиторий

Это монорепозиторий для сервера Model Context Protocol, который предоставляет доступ ко всем API Twilio.

Что такое MCP?

Model Context Protocol (MCP) — это протокол для обмена контекстной информацией модели между ИИ-инструментами и сервисами. Данная реализация позволяет предоставить API Twilio ИИ-ассистентам и другим инструментам, поддерживающим протокол MCP.

Пакеты

Этот монорепозиторий содержит два основных пакета:

  • mcp — MCP-сервер для всех публичных API Twilio
  • openapi-mcp-server — MCP-сервер, обслуживающий переданную спецификацию OpenAPI

Каждый пакет имеет собственный подробный README с детальной документацией:

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

Самый простой способ начать — использовать npx:

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp",
        "YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET"
      ]
    }
  }
}

Посетите документацию по ключам API Twilio для получения информации о том, как найти или создать ваш API Key и Secret.

Рекомендации по безопасности

Для защиты от атак с внедрением, которые могут позволить недоверенным системам получить доступ к вашим данным Twilio, команда ETI рекомендует пользователям Twilio MCP-серверов избегать установки или запуска любых сторонних MCP-серверов вместе с нашими официальными. Это помогает гарантировать, что только доверенные MCP-серверы имеют доступ к инструментам, взаимодействующим с вашей учётной записью Twilio, снижая риск несанкционированного доступа к данным.

Основные параметры конфигурации

Оба пакета принимают параметры конфигурации. Вот краткий обзор:

  • MCP Server: Используйте --services и --tags для фильтрации предоставляемых API
  • OpenAPI MCP Server: Используйте --apiPath для указания расположения файлов спецификации OpenAPI

Для получения полной информации о конфигурации обратитесь к документации конкретного пакета по ссылкам выше.

Разработка

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

Устранение распространённых проблем

  • Ограничения размера контекста: Из-за ограничений контекста LLM загружайте конкретные API с помощью --services или --tags
  • Проблемы аутентификации: Проверьте формат и разрешения ваших учётных данных Twilio API
  • Версионирование API: Убедитесь, что вы используете правильную версию API (v1, v2, v3) для ваших нужд

Подробные инструкции по устранению неполадок смотрите в документации конкретного пакета.

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

Мы приветствуем ваш вклад! Пожалуйста, не стесняйтесь отправлять Pull Request.

Лицензия

Этот проект лицензирован под лицензией ISC — подробности смотрите в файле LICENSE.