Deshartman Twilio Agent Payments MCP Server

🚀 Twilio MCP 服務器

Twilio 的 MCP（MCP 協議）服務器是一款強大的工具，可與 Claude 桌面集成。它為開發者提供了豐富的 API 和功能，能簡化支付處理、語音通話及其他通信相關任務。本文檔將詳細介紹該服務器的功能、使用方法和配置細節。

🚀 快速開始

要手動啟動 MCP 服務器進行測試，請運行以下命令：

# 使用實際憑證運行
node build/index.js "your_account_sid_here" "your_api_key_here" "your_api_secret"

# 或使用 npm 腳本（開發環境）
npm run dev -- "your_account_sid_here" "your_api_key_here" "your_api_secret"

當在 Claude 桌面中使用時，服務器會自動啟動。

✨ 主要特性

1. 支付處理

• 支付會話創建：提供 createPaymentSession 方法來初始化新的支付會話。
• 支付信息捕獲：提供 capturePaymentInfo 方法來收集和處理用戶支付信息。
• 支付狀態查詢：提供 getPaymentStatus 方法來獲取特定支付會話的狀態。

2. 語音通信

• 通話連接：提供 connectCall 方法來建立新的通話連接。
• 呼叫轉移：提供 forwardCall 方法將傳入的呼叫轉移到指定號碼。
• 媒體處理：支持通過 Twilio 的 Media API 處理音頻和視頻流。

3. 日誌記錄

• 事件驅動日誌記錄架構：所有工具和資源類均繼承自 Node.js 的 EventEmitter，並 emits 'log' 事件以記錄操作。
• 日誌級別支持：支持以下日誌級別：info、error、debug 和 warn（自動轉換為 info 級別）。

4. 回調數據處理

• 初始連接器數據：當支付會話首次創建時，Twilio 發送連接器數據。
• 捕獲數據更新：在支付信息被捕獲時，Twilio 發送更新的回調數據。

💻 使用示例

基礎用法

初始化服務器

# 使用實際憑證運行
node build/index.js "your_account_sid_here" "your_api_key_here" "your_api_secret"

# 或使用 npm 腳本（開發環境）
npm run dev -- "your_account_sid_here" "your_api_key_here" "your_api_secret"

日誌記錄規範

// 工具日誌的事件監聽
startPaymentCaptureTool.on(LOG_EVENT, logToMcp);
captureCardNumberTool.on(LOG_EVENT, logToMcp);
// 其他工具...

支付回調數據結構

初始連接器數據

{
  "PaymentConnector": "PGP_MOCK",
  "DateCreated": "2021-08-10T03:55:53.408Z",
  "PaymentMethod": "credit-card",
  "CallSid": "CAzzzzz",
  "ChargeAmount": "100.00",
  "Currency": "USD"
}

捕獲數據更新

{
  "PaymentStatus": "captured",
  "Amount": "100.00",
  "TransactionId": "ABC123DEF"
}

錯誤日誌示例

{
  "error": {
    "code": "401 Unauthorized",
    "message": "Invalid authentication credentials"
  }
}

📚 詳細文檔

兼容性說明

與 MCP 檢查工具兼容性

• 日誌級別處理：自動將 'warn' 級別轉換為 'info' 級別。

安全注意事項

• PCI 合規性：服務器遵循 PCI 標準，確保支付信息的安全存儲和傳輸。
• 憑證管理：建議使用環境變量或安全的憑證管理系統來存儲敏感信息。

錯誤處理

常見錯誤

1. 無效憑證：確保提供的 Account SID、API Key 和 Secret 是有效的 Twilio 憑證。
2. 網絡問題：檢查服務器和 Twilio 服務之間的網絡連接是否正常。

🔧 技術細節

日誌記錄

• 事件驅動日誌記錄系統：所有工具和資源類均繼承自 Node.js 的 EventEmitter 並 emits 'log' 事件。
• 日誌轉發：這些事件被捕獲並轉發到 MCP 服務器的日誌系統。

總結

Twilio 的 MCP 服務器是一個功能強大且靈活的工具，能夠幫助開發者高效地處理支付和通信相關任務。通過遵循本文檔中的指南，您可以輕鬆集成和配置該服務器以滿足各種需求。