Twilio

官方

與 Twilio API 互動，以發送訊息、管理電話號碼、設定帳戶等。

GitHub
109

你可以用 Twilio MCP 做什麼？

  • 發送簡訊與 WhatsApp 訊息 — 請您的助手透過 Twilio 的訊息 API 撰寫並發送訊息。
  • 撥打與管理電話 — 透過 Twilio Voice API 發起外撥電話、追蹤通話狀態或即時調整進行中的通話。
  • 查詢電話號碼 — 使用 Twilio Lookup 查詢任何電話號碼的電信業者與來電者名稱資訊。
  • 購買與設定電話號碼 — 透過電話號碼 API 搜尋可用號碼，並在您的帳戶中進行配置。
  • 依服務篩選開放的 API — 使用 --services 與 --tags 參數限制助手可存取的 Twilio API，以減少上下文大小。

文件

Twilio AlphaTwilio Alpha

Twilio MCP 單一儲存庫

這是一個用於 Model Context Protocol 伺服器的單一儲存庫，可公開所有 Twilio API。

什麼是 MCP？

Model Context Protocol (MCP) 是一種用於在 AI 工具與服務之間交換模型上下文資訊的通訊協定。此實作可讓您將 Twilio 的 API 公開給 AI 助理及其他支援 MCP 協定的工具。

套件

此單一儲存庫包含兩個主要套件：

  • mcp - 適用於所有 Twilio 公開 API 的 MCP 伺服器
  • openapi-mcp-server - 一個提供指定 OpenAPI 規格的 MCP 伺服器

每個套件都有自己詳盡的 README 及詳細文件：

快速入門

最簡單的入門方式是使用 npx：

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

請造訪 Twilio API 金鑰文件 以取得如何尋找或建立 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 檔案。