🚀 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
👥 贡献指南
- Fork 该仓库
- 创建功能分支
- 提交更改
- 推送到分支
- 提出 Pull Request