Twilio

ทางการ

โต้ตอบกับ API ของ Twilio เพื่อส่งข้อความ จัดการหมายเลขโทรศัพท์ กำหนดค่าบัญชี และอื่นๆ

GitHub
109

คุณทำอะไรได้บ้างด้วย Twilio MCP?

  • ส่งข้อความ SMS และ WhatsApp — ให้ผู้ช่วยของคุณเขียนและส่งข้อความผ่าน API การส่งข้อความของ Twilio
  • โทรออกและจัดการสาย — เริ่มต้นการโทรออก ติดตามสถานะสาย หรือปรับเปลี่ยนสายที่กำลังดำเนินการผ่าน Twilio Voice API
  • ค้นหาหมายเลขโทรศัพท์ — ดึงข้อมูลผู้ให้บริการเครือข่ายและชื่อผู้โทรสำหรับหมายเลขโทรศัพท์ใดๆ โดยใช้ Twilio Lookup
  • ซื้อและกำหนดค่าหมายเลขโทรศัพท์ — ค้นหาหมายเลขที่ว่างและจัดสรรให้กับบัญชีของคุณผ่าน API หมายเลขโทรศัพท์
  • กรอง API ที่เปิดเผยตามบริการ — ใช้แฟล็ก --services และ --tags เพื่อจำกัดว่า Twilio API ใดบ้างที่ผู้ช่วยสามารถเข้าถึงได้ ซึ่งช่วยลดขนาดของบริบท

เอกสาร

Twilio AlphaTwilio Alpha

Twilio MCP Monorepo

นี่คือ monorepo สำหรับเซิร์ฟเวอร์ Model Context Protocol ที่เปิดเผย API ทั้งหมดของ Twilio

MCP คืออะไร?

Model Context Protocol (MCP) คือโปรโตคอลสำหรับการแลกเปลี่ยนข้อมูลบริบทของโมเดลระหว่างเครื่องมือ AI และบริการต่างๆ การนำไปใช้งานนี้ช่วยให้คุณสามารถเปิดเผย API ของ Twilio ให้กับผู้ช่วย AI และเครื่องมืออื่นๆ ที่รองรับโปรโตคอล MCP

แพ็คเกจ

monorepo นี้ประกอบด้วยแพ็คเกจหลักสองแพ็คเกจ:

  • mcp - เซิร์ฟเวอร์ MCP สำหรับ Public API ทั้งหมดของ Twilio
  • openapi-mcp-server - เซิร์ฟเวอร์ MCP ที่ให้บริการตาม OpenAPI spec ที่กำหนด

แต่ละแพ็คเกจมี README ที่ครอบคลุมพร้อมเอกสารประกอบโดยละเอียด:

เริ่มต้นอย่างรวดเร็ว

วิธีที่ง่ายที่สุดในการเริ่มต้นคือการใช้ npx:

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

เข้าไปที่ เอกสาร Twilio API Keys สำหรับข้อมูลเกี่ยวกับวิธีค้นหา/สร้าง API Key และ Secret ของคุณ

คำแนะนำด้านความปลอดภัย

เพื่อป้องกันการโจมตีแบบ injection ที่อาจทำให้ระบบที่ไม่น่าเชื่อถือเข้าถึงข้อมูล Twilio ของคุณ ทีม ETI แนะนำให้ผู้ใช้เซิร์ฟเวอร์ Twilio MCP หลีกเลี่ยงการติดตั้งหรือรันเซิร์ฟเวอร์ MCP จากชุมชนใดๆ ควบคู่ไปกับเซิร์ฟเวอร์อย่างเป็นทางการของเรา การทำเช่นนี้จะช่วยให้มั่นใจได้ว่าเฉพาะเซิร์ฟเวอร์ MCP ที่เชื่อถือได้เท่านั้นที่สามารถเข้าถึงเครื่องมือที่โต้ตอบกับบัญชี Twilio ของคุณ ซึ่งช่วยลดความเสี่ยงในการเข้าถึงข้อมูลโดยไม่ได้รับอนุญาต

ตัวเลือกการกำหนดค่าพื้นฐาน

ทั้งสองแพ็คเกจยอมรับพารามิเตอร์การกำหนดค่า นี่คือภาพรวมโดยย่อ:

  • เซิร์ฟเวอร์ MCP: ใช้ --services และ --tags เพื่อกรองว่าจะเปิดเผย API ใด
  • เซิร์ฟเวอร์ OpenAPI MCP: ใช้ --apiPath เพื่อระบุตำแหน่งไฟล์ OpenAPI spec

สำหรับรายละเอียดการกำหนดค่าทั้งหมด โปรดดูเอกสารประกอบเฉพาะแพ็คเกจที่ลิงก์ไว้ด้านบน

การพัฒนา

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

การแก้ไขปัญหาทั่วไป

  • ข้อจำกัดขนาด Context: เนื่องจากข้อจำกัด context ของ LLM ให้โหลด API เฉพาะโดยใช้ --services หรือ --tags
  • ปัญหาการตรวจสอบสิทธิ์: ตรวจสอบรูปแบบและสิทธิ์ของข้อมูลประจำตัว Twilio API ของคุณ
  • การกำหนดเวอร์ชัน API: ตรวจสอบว่าคุณใช้เวอร์ชัน API ที่ถูกต้อง (v1, v2, v3) สำหรับความต้องการของคุณ

สำหรับคำแนะนำการแก้ไขปัญหาโดยละเอียด โปรดดูเอกสารประกอบเฉพาะแพ็คเกจ

การมีส่วนร่วม

ยินดีต้อนรับการมีส่วนร่วม! โปรดส่ง Pull Request ได้ตามสบาย

ใบอนุญาต

โปรเจกต์นี้ได้รับอนุญาตภายใต้ ISC License - ดูรายละเอียดได้ที่ไฟล์ LICENSE