Un-Official PayPal MCP Server

非公式 PayPal MCP サーバー

PayPal API との連携を実現する、Model Context Protocol（MCP）サーバーの Python 実装です。このサーバーを使うと、LLM が関数呼び出しを通じて PayPal の API を操作できます。

機能

• PayPal API 向けの Model Context Protocol を完全に実装
• 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

使用方法

コマンドライン

# Using environment variables
export PAYPAL_ACCESS_TOKEN="your_access_token"
export PAYPAL_ENVIRONMENT="SANDBOX"  # or "PRODUCTION"
paypal-mcp --tools=all

# Or with command line arguments
paypal-mcp --tools=all --access-token=your_access_token --paypal-environment=SANDBOX

特定のツールのみを有効にする

paypal-mcp --tools=invoices.create,invoices.list,orders.create --access-token=your_token

Docker を使用

docker run -e PAYPAL_ACCESS_TOKEN="your_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"

開発

開発環境のセットアップ

# Clone the repository
git clone https://github.com/yourusername/paypal-mcp-server.git
cd paypal-mcp-server

# Install dev dependencies
pip install -e ".[dev]"

# Install pre-commit hooks
pre-commit install

テストの実行

pytest -xvs

パッケージのビルド

python -m build

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

謝辞

• PayPal の Agent Toolkit を基にしています
• Model Context Protocol 仕様に準拠しています