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