MCP Server (deprecated)

🚀 MCP 服務器（已棄用）

一個提供與 PayPal API 全面集成的 Model Context Protocol (MCP) 服務器。該服務器藉助標準化接口，可實現對 PayPal 的支付處理、發票生成、訂閱管理和業務操作的無縫交互，為開發者提供便捷的支付解決方案。

🚀 快速開始

安裝依賴

npm install

啟動服務器

npm start

✨ 主要特性

支付處理

• 訂單管理：創建、更新和跟蹤訂單
• 支付處理：處理各種方式的付款
• 令牌化支付：使用支付令牌進行安全的後續付款
• 訂閱管理：創建和管理重複性付款計劃

業務操作

• 產品目錄：添加和管理銷售商品與服務
• 發票生成：生成併發送專業發票
• 批量 payout：處理多個收款方的大額轉賬
• 優惠活動：設置和管理促銷及折扣活動

📦 安裝指南

依賴安裝

npm install

配置文件編輯

編輯 config.json 文件：

{
  "port": 3000,
  "paypalClientId": "YOUR_CLIENT_ID",
  "paypalClientSecret": "YOUR_CLIENT_SECRET"
}

💻 使用示例

基礎用法

創建訂單

POST /api/orders
Content-Type: application/json

{
  "amount": {
    "value": "100.00",
    "currency": "USD"
  },
  "description": "Example product"
}

捕獲付款

POST /api/payments/capture
Content-Type: application/json

{
  "order_id": "PAY-XXXXX",
  "payment_token": "TOKEN-XXXXX"
}

📚 詳細文檔

所有 API 端點均配有詳細文檔，包括請求參數、響應格式和示例。

🔧 技術細節

服務器端

• 使用 TypeScript 編寫，確保類型安全和代碼可維護性
• 基於 Express 框架構建高性能 RESTful API
• 集成 PayPal SDK 實現深度集成
• 使用環境變量管理敏感配置信息
• 內置錯誤處理模塊確保 API 穩定性

客戶端

• 提供簡潔易用的開發者接口
• 支持多種請求格式（JSON, XML）
• 自動生成 API 文檔便於使用
• 提供示例代碼加速開發流程
• 具備完整的鑑權機制保障安全

錯誤處理

服務器端採用多層次錯誤處理機制：

• 輸入驗證：詳細檢查所有請求參數
• 異常捕獲：記錄所有未處理異常
• 重試機制：針對網絡問題自動重試
• 限流策略：防止 API 被濫用

安全措施

• 所有敏感信息均經過加密處理
• 使用 OAuth 2.0 協議進行身份驗證
• 配置 HTTPS 確保數據傳輸安全
• 定期進行安全審計和漏洞修復

📄 許可證

MIT License

🔧 開發指引

項目構建

npm run build

開發模式啟動

npm run dev

測試運行

npm test

代碼格式化

npm run format

👥 貢獻指南

1. Fork 該倉庫
2. 創建功能分支
3. 提交更改
4. 推送到分支
5. 提出 Pull Request