Twilio MCP Server

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 ที่ครอบคลุมพร้อมเอกสารประกอบโดยละเอียด:

• เอกสารประกอบแพ็คเกจ MCP
• เอกสารประกอบเซิร์ฟเวอร์ OpenAPI MCP

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

วิธีที่ง่ายที่สุดในการเริ่มต้นคือการใช้ 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