Paypal MCP

🚀 PayPal MCP 服務器

PayPal MCP 服務器由 DynamicEndpoints 維護，為用戶提供與 PayPal 支付相關的功能服務，可實現訂單創建、發票生成、匯款處理等操作。

🚀 快速開始

若你想使用本 PayPal MCP 服務器，可按以下步驟進行操作：

1. 克隆倉庫：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 安裝依賴項：

   npm install
   

3. 啟動服務器：

   node index.js
   

✨ 主要特性

• 功能豐富：支持創建訂單、發票以及處理匯款等多種 PayPal 相關業務。
• 錯誤處理全面：實現了對輸入驗證錯誤、PayPal API 錯誤、網絡和身份驗證錯誤、速率限制和超時等情況的處理。
• 安全可靠：對敏感數據進行驗證和清理，採用 PayPal 的 OAuth 2.0 身份驗證，通過環境變量管理安全憑證，驗證所有 API 參數，且錯誤消息不會洩露敏感信息。
• 便於開發：提供構建、測試和調試命令，服務器輸出詳細日誌輔助開發。

💻 使用示例

基礎用法

創建訂單

const result = await mcpClient.useTool('paypal', 'create_order', {
  intent: 'CAPTURE',
  purchase_units: [{
    amount: {
      currency_code: 'USD',
      value: '100.00'
    },
    description: '高級訂閱'
  }]
});

創建發票

const result = await mcpClient.useTool('paypal', 'create_invoice', {
  invoice_number: 'INV-2024-001',
  reference: 'REF-2024-001',
  currency_code: 'USD',
  recipient_email: 'customer@example.com',
  items: [{
    name: '諮詢服務',
    quantity: '1',
    unit_amount: {
      currency_code: 'USD',
      value: '500.00'
    }
  }]
});

處理匯款

const result = await mcpClient.useTool('paypal', 'create_payout', {
  sender_batch_header: {
    sender_batch_id: 'PAY-2024_001',
    email_subject: '您已收到款項'
  },
  items: [{
    recipient_type: 'EMAIL',
    amount: {
      value: '1000.00',
      currency: 'USD'
    },
    receiver: 'employee@example.com',
    note: '月度工資支付'
  }]
});

🔧 技術細節

該服務器實現了全面的錯誤處理，涵蓋輸入驗證錯誤（帶有詳細消息）、PayPal API 錯誤（包含響應詳情）、網絡和身份驗證錯誤以及速率限制和超時處理。同時，在安全方面，所有敏感數據經過驗證和清理，使用 PayPal 的 OAuth 2.0 身份驗證，通過環境變量管理安全憑證，驗證所有 API 參數，且錯誤消息不洩露敏感信息。

📚 詳細文檔

開發

構建

npm run build

測試

npm test

調試

服務器輸出詳細日誌以幫助調試，可處理身份驗證問題、API 調用失敗、驗證錯誤以及查看請求/響應詳情。

貢獻指南

1. 克隆倉庫：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 創建功能分支：

   git checkout -b feature/your-feature
   

3. 提交更改：

   git add .
   git commit -m '添加新功能'
   

4. 推送到分支：

   git push origin feature/your-feature
   

5. 創建拉取請求

📄 許可證

本項目採用 MIT 許可證。