Twilio MCP Server

Twilio MCP Monorepo

Đây là monorepo dành cho máy chủ Model Context Protocol, cung cấp quyền truy cập vào tất cả các API của Twilio.

MCP là gì?

Model Context Protocol (MCP) là một giao thức dùng để trao đổi thông tin ngữ cảnh mô hình giữa các công cụ và dịch vụ AI. Bản triển khai này cho phép bạn cung cấp các API của Twilio cho trợ lý AI và các công cụ khác hỗ trợ giao thức MCP.

Các gói

Monorepo này chứa hai gói chính:

• mcp - Máy chủ MCP cho toàn bộ API công khai của Twilio
• openapi-mcp-server - Máy chủ MCP phục vụ đặc tả OpenAPI được cung cấp

Mỗi gói đều có tệp README riêng với tài liệu chi tiết:

• Tài liệu gói MCP
• Tài liệu máy chủ OpenAPI MCP

Bắt đầu nhanh

Cách dễ nhất để bắt đầu là sử dụng npx:

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

Truy cập tài liệu Twilio API Keys để biết cách tìm/tạo Khóa API và Mã bí mật của bạn.

Khuyến nghị bảo mật

Để phòng tránh các cuộc tấn công chèn mã có thể cho phép các hệ thống không đáng tin cậy truy cập vào dữ liệu Twilio của bạn, nhóm ETI khuyên người dùng máy chủ Twilio MCP không nên cài đặt hoặc chạy bất kỳ máy chủ MCP cộng đồng nào cùng với máy chủ chính thức của chúng tôi. Làm như vậy giúp đảm bảo chỉ những máy chủ MCP đáng tin cậy mới có quyền truy cập vào các công cụ tương tác với tài khoản Twilio của bạn, giảm nguy cơ truy cập dữ liệu trái phép.

Tùy chọn cấu hình cơ bản

Cả hai gói đều chấp nhận tham số cấu hình. Dưới đây là tổng quan ngắn gọn:

• Máy chủ MCP: Sử dụng --services và --tags để lọc những API nào được cung cấp
• Máy chủ OpenAPI MCP: Sử dụng --apiPath để chỉ định vị trí tệp đặc tả OpenAPI

Để biết chi tiết cấu hình đầy đủ, hãy tham khảo tài liệu riêng của từng gói được liên kết ở trên.

Phát triển

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

Khắc phục các sự cố thường gặp

• Giới hạn kích thước ngữ cảnh: Do giới hạn ngữ cảnh của LLM, hãy tải các API cụ thể bằng cách sử dụng --services hoặc --tags
• Sự cố xác thực: Xác minh định dạng và quyền của thông tin xác thực API Twilio
• Phiên bản API: Kiểm tra xem bạn đang sử dụng đúng phiên bản API (v1, v2, v3) cho nhu cầu của mình

Để được hướng dẫn khắc phục sự cố chi tiết, hãy xem tài liệu riêng của từng gói.

Đóng góp

Mọi đóng góp đều được hoan nghênh! Vui lòng gửi Pull Request.

Giấy phép

Dự án này được cấp phép theo Giấy phép ISC - xem tệp LICENSE để biết chi tiết.