Paypal MCP Server

🚀 PayPal MCP サーバー

Python で実装された PayPal API 統合用のモデルコンテキストプロトコル（MCP）サーバーです。このサーバーにより、大規模言語モデル（LLMs）は機能呼び出しを通じて PayPal の API と相互作用することができます。

✨ 主な機能

• PayPal API のモデルコンテキストプロトコル（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/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 をベースにしています。
• モデルコンテキストプロトコル 仕様と互換性があります。