JinDaGe - deshartman_twilio-agent-payments-mcp-server MCP Details

article

README

🚀 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 标准，确保支付信息的安全存储和传输。
凭证管理：建议使用环境变量或安全的凭证管理系统来存储敏感信息。

错误处理

常见错误

无效凭证：确保提供的 Account SID、API Key 和 Secret 是有效的 Twilio 凭证。
网络问题：检查服务器和 Twilio 服务之间的网络连接是否正常。

🔧 技术细节

日志记录

事件驱动日志记录系统：所有工具和资源类均继承自 Node.js 的 EventEmitter 并 emits 'log' 事件。
日志转发：这些事件被捕获并转发到 MCP 服务器的日志系统。

总结

Twilio 的 MCP 服务器是一个功能强大且灵活的工具，能够帮助开发者高效地处理支付和通信相关任务。通过遵循本文档中的指南，您可以轻松集成和配置该服务器以满足各种需求。

deshartman_twilio-agent-payments-mcp-server