Paypal

🚀 PayPal MCP 服務器

一個提供與PayPal API集成的模型上下文協議（MCP）服務器。此服務器藉助標準化接口，實現與PayPal在支付處理、發票開具、訂閱管理和業務操作等方面的無縫交互，為業務流程提供便利。

🚀 快速開始

本服務器可幫助您輕鬆實現與PayPal API的集成。以下是啟動項目的基本步驟。

安裝

# 克隆倉庫
git clone https://github.com/arbuthnot-eth/PayPal-MCP-Backdated.git
cd PayPal-MCP-Backdated

# 安裝依賴
npm install

# 構建項目
npm run build

配置

在根目錄下創建一個.env文件，添加您的PayPal API憑證：

PAYPAL_CLIENT_ID=your_client_id_here
PAYPAL_CLIENT_SECRET=your_client_secret_here
PAYPAL_ENVIRONMENT=sandbox  # 或 'live' 表示生產環境

運行服務器

# 啟動服務器
npm start

# 開發環境下自動重載
npm run dev

MCP 配置

將服務器添加到您的MCP配置文件中：

{
  "mcpServers": {
    "paypal": {
      "command": "node",
      "args": ["path/to/paypal-mcp/build/index.js"],
      "env": {
        "PAYPAL_CLIENT_ID": "your_client_id",
        "PAYPAL_CLIENT_SECRET": "your_client_secret",
        "PAYPAL_ENVIRONMENT": "sandbox"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

✨ 主要特性

• 支付處理：創建和捕獲支付、訂單及支付令牌
• 訂閱管理：創建並管理重複性訂閱
• 業務操作：創建產品、生成發票並處理匯款
• 用戶管理：檢索用戶信息並創建網絡配置 профілі
• 安全認證：自動的令牌管理與刷新處理
• 輸入驗證：使用Zod模式進行全面驗證
• 錯誤處理：強大的錯誤處理和日誌記錄

💻 使用示例

基礎用法

本服務器提供了豐富的工具來滿足不同的業務需求，以下是一些常用工具的使用示例。

支付工具

• create_payment_token：創建供未來使用的支付令牌
• create_order：創建新的PayPal訂單
• capture_order：捕獲授權訂單的付款
• create_payment：創建直接付款
• create_subscription：為重複計費創建訂閱

業務工具

• create_product：創建目錄中的新商品
• create_invoice：生成新的發票
• create_payout：處理批量匯款

用戶工具

• get_userinfo：檢索用戶信息
• create_web_profile：創建網絡體驗配置 профіл
• get_web_profiles：獲取網絡體驗配置 profail列表

📚 詳細文檔

開發

# 運行代碼檢查
npm run lint

# 執行測試
npm test

# 格式化代碼
npm run format

📄 許可證

該項目採用MIT許可證，詳細信息請參閱LICENSE文件。