Twilio MCP Server

Twilio MCP Monorepo

Ini adalah monorepo untuk server Model Context Protocol yang mengekspos seluruh API Twilio.

Apa itu MCP?

Model Context Protocol (MCP) adalah protokol untuk bertukar informasi konteks model antara alat dan layanan AI. Implementasi ini memungkinkan Anda mengekspos API Twilio ke asisten AI dan alat lain yang mendukung protokol MCP.

Paket

Monorepo ini berisi dua paket utama:

• mcp - Server MCP untuk seluruh API Publik Twilio
• openapi-mcp-server - Server MCP yang menyajikan spesifikasi OpenAPI yang diberikan

Setiap paket memiliki README lengkap dengan dokumentasi terperinci:

• Dokumentasi Paket MCP
• Dokumentasi Server OpenAPI MCP

Mulai Cepat

Cara termudah untuk memulai adalah dengan menggunakan npx:

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

Kunjungi dokumen Twilio API Keys untuk informasi tentang cara menemukan/membuat API Key dan Secret Anda.

Rekomendasi Keamanan

Untuk melindungi dari serangan injeksi yang dapat memberikan akses sistem tidak tepercaya ke data Twilio Anda, tim ETI menyarankan pengguna server Twilio MCP untuk menghindari menginstal atau menjalankan server MCP komunitas bersamaan dengan server resmi kami. Melakukan hal tersebut membantu memastikan bahwa hanya server MCP tepercaya yang memiliki akses ke alat yang berinteraksi dengan akun Twilio Anda, mengurangi risiko akses data yang tidak sah.

Opsi Konfigurasi Dasar

Kedua paket menerima parameter konfigurasi. Berikut ringkasan singkatnya:

• Server MCP: Gunakan --services dan --tags untuk memfilter API mana yang akan diekspos
• Server OpenAPI MCP: Gunakan --apiPath untuk menentukan lokasi file spesifikasi OpenAPI

Untuk detail konfigurasi lengkap, lihat dokumentasi spesifik paket yang ditautkan di atas.

Pengembangan

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

Pemecahan Masalah Umum

• Batasan Ukuran Konteks: Karena batasan konteks LLM, muat API spesifik menggunakan --services atau --tags
• Masalah Autentikasi: Verifikasi format dan izin kredensial API Twilio Anda
• Pembuatan Versi API: Periksa apakah Anda menggunakan versi API yang benar (v1, v2, v3) untuk kebutuhan Anda

Untuk panduan pemecahan masalah terperinci, lihat dokumentasi spesifik paket.

Berkontribusi

Kontribusi sangat diterima! Silakan kirimkan Pull Request.

Lisensi

Proyek ini dilisensikan di bawah Lisensi ISC - lihat file LICENSE untuk detailnya.