Twilio MCP Server

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

Что такое МКП?

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

Related MCP server: Aligo SMS MCP Server

Пакеты

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

• mcp — MCP-сервер для всех публичных API Twilio

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

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

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

• Документация сервера OpenAPI MCP

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

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

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

Информацию о том, как найти/создать свой ключ API и секрет, можно найти в документации Twilio API Keys .

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

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

• Проблемы с аутентификацией : проверьте формат и разрешения учетных данных API Twilio.

• Управление версиями API : убедитесь, что вы используете правильную версию API (v1, v2, v3) для своих нужд.

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

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Лицензия

Данный проект лицензирован по лицензии ISC — подробности см. в файле ЛИЦЕНЗИЯ.