🚀 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文件。