paypal_mcp_server

🚀 PayPal MCP 服务器

这是一个基于 Python 实现的 PayPal API 集成用模型上下文协议（MCP）服务器。该服务器为大型语言模型（LLMs）提供了通过功能调用来与 PayPal 的 APIs 进行交互的能力，极大地拓展了语言模型在支付相关场景的应用。

🚀 快速开始

PayPal MCP 服务器允许大型语言模型（LLMs）通过功能调用来与 PayPal 的 APIs 进行交互。你可以按照以下步骤进行安装和使用。

✨ 主要特性

• 完整实现 PayPal APIs 的模型上下文协议（MCP）。
• 支持所有主要的 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。
• 与 模型上下文协议 规范兼容。