Twilio MCP Server

Twilio MCP 모노레포

이 저장소는 모든 Twilio API를 노출하는 Model Context Protocol 서버를 위한 모노레포입니다.

MCP란?

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

패키지

이 모노레포에는 두 가지 주요 패키지가 포함되어 있습니다:

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

각 패키지에는 자세한 문서가 담긴 자체 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 키 문서를 참조하세요.

보안 권장 사항

신뢰할 수 없는 시스템이 Twilio 데이터에 접근할 수 있게 하는 인젝션 공격을 방지하기 위해, ETI 팀은 Twilio MCP 서버 사용자에게 공식 서버와 함께 커뮤니티 MCP 서버를 설치하거나 실행하지 말 것을 권고합니다. 이렇게 하면 신뢰할 수 있는 MCP 서버만 Twilio 계정과 상호 작용하는 도구에 접근할 수 있도록 보장하여 무단 데이터 접근 위험을 줄일 수 있습니다.

기본 구성 옵션

두 패키지 모두 구성 매개변수를 허용합니다. 간략한 개요는 다음과 같습니다:

• MCP 서버: --services 및 --tags을 사용하여 노출할 API를 필터링합니다.
• OpenAPI MCP 서버: --apiPath를 사용하여 OpenAPI 명세 파일 위치를 지정합니다.

전체 구성 세부 사항은 위에 링크된 패키지별 문서를 참조하세요.

개발

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

일반적인 문제 해결

• 컨텍스트 크기 제한: LLM 컨텍스트 제한으로 인해 --services 또는 --tags을 사용하여 특정 API를 로드하세요.
• 인증 문제: Twilio API 자격 증명 형식과 권한을 확인하세요.
• API 버전 관리: 필요에 맞는 올바른 API 버전(v1, v2, v3)을 사용하고 있는지 확인하세요.

자세한 문제 해결 안내는 패키지별 문서를 참조하세요.

기여

기여를 환영합니다! 언제든지 Pull Request를 제출해 주세요.

라이선스

이 프로젝트는 ISC 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.