twilio-labs/mcp

트윌리오 MCP 모노레포

이것은 Twilio API의 모든 것을 노출하는 모델 컨텍스트 프로토콜 서버의 모노레포입니다.

MCP란 무엇인가?

모델 컨텍스트 프로토콜(MCP)은 AI 도구와 서비스 간에 모델 컨텍스트 정보를 교환하기 위한 프로토콜입니다. 이 구현을 통해 Twilio의 API를 MCP 프로토콜을 지원하는 AI 어시스턴트 및 기타 도구에 노출할 수 있습니다.

소포

이 모노레포는 두 가지 주요 패키지를 포함하고 있습니다:

• mcp - Twilio 모든 공개 API를 위한 MCP 서버
• openapi-mcp-server - 주어진 OpenAPI 사양을 제공하는 MCP 서버

각 패키지는 상세 문서가 포함된 포괄적인 README를 가지고 있습니다:

• MCP 패키지 문서
• OpenAPI MCP 서버 문서

퀵 스타트

가장 쉬운 시작 방법은 npx를 사용하는 것입니다:

API 키와 시크릿을 찾고 만드는 방법에 대한 정보는 Twilio API 키 문서를 방문해 보세요.

보안 권고

신뢰할 수 없는 시스템이 Twilio 데이터에 접근할 수 있는 인젝션 공격을 방지하기 위해, ETI 팀은 Twilio MCP 서버 사용자들에게 공식 MCP 서버 외에 커뮤니티 MCP 서버를 설치하거나 운영하지 말 것을 권고합니다.

Twilio MCP Monorepo

This is a monorepo for the Model Context Protocol server that exposes all of Twilio APIs.

What is MCP?

The Model Context Protocol (MCP) is a protocol for exchanging model context information between AI tools and services. This implementation allows you to expose Twilio’s APIs to AI assistants and other tools that support the MCP protocol.

Packages

This monorepo contains two main packages:

• mcp - MCP Server for all of Twilio’s Public API
• openapi-mcp-server - An MCP server that serves the given OpenAPI spec

Each package has its own comprehensive README with detailed documentation:

• MCP Package Documentation
• OpenAPI MCP Server Documentation

Quick Start

The easiest way to get started is by using npx:

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

Visit Twilio API Keys docs for information on how to find/create your API Key and Secret.

Security Recommendations

To guard against injection attacks that may allow untrusted systems access to your Twilio data, the ETI team advises users of Twilio MCP servers to avoid installing or running any community MCP servers alongside our official ones. Doing so helps ensure that only trusted MCP servers have access to tools interacting with your Twilio account, reducing the risk of unauthorized data access.

Basic Configuration Options

Both packages accept configuration parameters. Here’s a brief overview:

• MCP Server: Use --services and --tags to filter which APIs to expose
• OpenAPI MCP Server: Use --apiPath to specify OpenAPI spec files location

For complete configuration details, refer to the package-specific documentation linked above.

Development

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

Troubleshooting Common Issues

• Context Size Limitations: Due to LLM context limits, load specific APIs using --services or --tags
• Authentication Issues: Verify your Twilio API credentials format and permissions
• API Versioning: Check you’re using the correct API version (v1, v2, v3) for your needs

For detailed troubleshooting guidance, see the package-specific documentation.

Contributing