PayPal MCP

电商官方认证本地 TypeScript

🚀 PayPal MCP 服务器

PayPal MCP 服务器由 DynamicEndpoints 维护，为用户提供与 PayPal 支付相关的功能服务，可实现订单创建、发票生成、汇款处理等操作。

🚀 快速开始

若你想使用本 PayPal MCP 服务器，可按以下步骤进行操作：

克隆仓库：

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

安装依赖项：
```
npm install
```
启动服务器：
```
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 调用失败、验证错误以及查看请求/响应详情。

贡献指南