Paypal MCP Server

🚀 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
• 與 模型上下文協議 規範兼容