🚀 PayPal MCP 服务器

PayPal MCP 服务器是一个基于 Python 实现的工具，它借助模型上下文协议（MCP）集成了 PayPal API。该服务器允许大型语言模型（LLMs）通过功能调用的方式与 PayPal 的 APIs 进行交互，为开发者和用户提供了便捷的支付处理解决方案。

✨ 主要特性

• 完整实现了 PayPal APIs 的模型上下文协议（MCP），确保与 PayPal 系统的无缝对接。
• 支持所有主要的 PayPal API 端点，涵盖了发票、订单、产品、订阅计划、订阅、货运单据、争议和交易等多个方面：
  • 发票：可进行创建、列表、查看、发送、提醒、取消以及生成 QR 码等操作。
  • 订单：支持创建、获取和捕获订单。
  • 产品：能够创建、列表、查看和更新产品信息。
  • 订阅计划：可创建、列表和查看订阅计划。
  • 订阅：支持创建、查看和取消订阅。
  • 货运单据：可创建和跟踪货运单据。
  • 争议：能列表、查看和接受争议处理。
  • 交易：支持列表和筛选交易信息。

📦 安装指南

从 PyPI 安装

pip install paypal-mcp-server

从源代码安装

git clone https://github.com/yourusername/paypal-mcp-server.git
cd paypal-mcp-server
pip install -e .

使用 Docker 安装

docker pull ghcr.io/yourusername/paypal-mcp-server:latest

💻 使用示例

命令行使用

# 使用环境变量
export PAYPAL_ACCESS_TOKEN="你的访问令牌"
export PAYPAL_ENVIRONMENT="SANDBOX"  # 或 "PRODUCTION"
paypal-mcp --tools=all

# 或使用命令行参数
paypal-mcp --tools=all --access-token=你的访问令牌 --paypal-environment=SANDBOX

启用特定工具

paypal-mcp --tools=invoices.create,invoices.list,orders.create --access-token=你的令牌

使用 Docker 运行

docker run -e PAYPAL_ACCESS_TOKEN="你的访问令牌" -e PAYPAL_ENVIRONMENT="SANDBOX" ghcr.io/yourusername/paypal-mcp-server:latest --tools=all

与 Claude Desktop 集成

在你的 ~/Claude/claude_desktop_config.json 中添加以下内容：

{
   "mcpServers": {
     "paypal": {
       "command": "paypal-mcp",
       "args": [
         "--tools=all"
       ],
       "env": {
         "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN",
         "PAYPAL_ENVIRONMENT": "SANDBOX"
       }
     }
   }
}

获取 PayPal 访问令牌

你可以使用你的客户端 ID 和客户端密钥生成一个 PayPal 访问令牌：

curl -v https://api-m.sandbox.paypal.com/v1/oauth2/token \
  -H "Accept: application/json" \
  -H "Accept-Language: en_US" \
  -u "CLIENT_ID:CLIENT_SECRET" \
  -d "grant_type=client_credentials"

🔧 技术细节

开发环境设置

# 克隆仓库
git clone https://github.com/yourusername/paypal-mcp-server.git
cd paypal-mcp-server

# 安装开发依赖项
pip install -e ".[dev]"

# 安装 pre-commit 钩子
pre-commit install

运行测试

pytest -xvs

构建包

python -m build

📄 许可证

此项目根据 MIT 许可证发布，详情请见 LICENSE 文件。

致谢

• 基于 PayPal 的 Agent Toolkit
• 与 模型上下文协议 规范兼容