PayPal MCP サーバー
PayPal APIとの包括的な統合を提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、標準化されたインターフェースを通じて、PayPalの支払い処理、請求、サブスクリプション管理、そしてビジネスオペレーションとのシームレスな連携を実現します。
特徴
支払い処理
注文管理: 注文の作成、更新、追跡
支払い処理：さまざまな方法で支払いを処理します
支払いトークン: 将来使用するために支払いトークンを作成および管理します
紛争管理：支払い紛争と解決を処理する
事業運営
製品管理：製品カタログの作成と管理
請求書発行: プロフェッショナルな請求書を作成して送信します
支払い：複数の受取人への一括支払い処理
サブスクリプション管理: 定期課金の作成と管理
ユーザー管理
本人確認: ユーザーの本人確認
ユーザー情報: ユーザーデータの取得と管理
Webプロファイル管理：チェックアウトエクスペリエンスをカスタマイズ
Related MCP server: PayPal MCP Server
建築
graph TB
subgraph "MCP Environment"
Client[MCP Client]
Server[PayPal MCP Server]
Validation[Input Validation]
Auth[OAuth Authentication]
Cache[Token Cache]
ErrorHandler[Error Handler]
end
subgraph "PayPal APIs"
Orders[Orders API]
Payments[Payments API]
Payouts[Payouts API]
Invoicing[Invoicing API]
Products[Products API]
Subscriptions[Subscriptions API]
Disputes[Disputes API]
Identity[Identity API]
end
Client --> |Request| Server
Server --> |Response| Client
Server --> Validation
Server --> Auth
Auth --> Cache
Auth --> |Access Token| PayPal
Server --> ErrorHandler
Server --> Orders
Server --> Payments
Server --> Payouts
Server --> Invoicing
Server --> Products
Server --> Subscriptions
Server --> Disputes
Server --> Identity
style Client fill:#f9f,stroke:#333,stroke-width:2px
style Server fill:#bbf,stroke:#333,stroke-width:2px
style Auth fill:#bfb,stroke:#333,stroke-width:2px
style Validation fill:#bfb,stroke:#333,stroke-width:2px
style Cache fill:#fbb,stroke:#333,stroke-width:2px
style ErrorHandler fill:#fbb,stroke:#333,stroke-width:2pxインストール
前提条件
Node.js 16.x 以降
API 認証情報を持つ PayPal 開発者アカウント
手動インストール
リポジトリをクローンする
git clone https://github.com/arbuthnot-eth/PayPal-MCP.git cd PayPal-MCP依存関係をインストールする
npm installプロジェクトを構築する
npm run buildMCP 設定ファイルで PayPal の資格情報を設定します。
{ "mcpServers": { "paypal": { "command": "node", "args": ["path/to/paypal-mcp/build/index.js"], "env": { "PAYPAL_CLIENT_ID": "your_client_id", "PAYPAL_CLIENT_SECRET": "your_client_secret", "PAYPAL_ENVIRONMENT": "sandbox" // or "live" }, "disabled": false, "autoApprove": [] } } }
利用可能なツール
支払い業務
支払いトークンの作成
将来使用するために支払いトークンを作成します。
{
customer: {
id: string;
email_address?: string;
};
payment_source: {
card?: {
name: string;
number: string;
expiry: string;
security_code: string;
};
paypal?: {
email_address: string;
};
};
}注文作成
PayPal で新しい注文を作成します。
{
intent: 'CAPTURE' | 'AUTHORIZE';
purchase_units: Array<{
amount: {
currency_code: string;
value: string;
};
description?: string;
reference_id?: string;
items?: Array<{
name: string;
quantity: string;
unit_amount: {
currency_code: string;
value: string;
};
}>;
}>;
application_context?: {
brand_name?: string;
shipping_preference?: 'GET_FROM_FILE' | 'NO_SHIPPING' | 'SET_PROVIDED_ADDRESS';
user_action?: 'CONTINUE' | 'PAY_NOW';
};
}キャプチャ順序
承認された注文の支払いを取得します。
{
order_id: string;
payment_source?: {
token?: {
id: string;
type: string;
};
};
}サブスクリプションの作成
定期課金のサブスクリプションを作成します。
{
plan_id: string;
subscriber: {
name: {
given_name: string;
surname: string;
};
email_address: string;
};
application_context?: {
brand_name?: string;
shipping_preference?: 'GET_FROM_FILE' | 'NO_SHIPPING' | 'SET_PROVIDED_ADDRESS';
user_action?: 'CONTINUE' | 'SUBSCRIBE_NOW';
payment_method?: {
payer_selected?: string;
payee_preferred?: string;
};
};
}事業運営
製品を作成する
カタログに新しい製品を作成します。
{
name: string;
description: string;
type: 'PHYSICAL' | 'DIGITAL' | 'SERVICE';
category: string;
image_url?: string;
home_url?: string;
}請求書作成
新しい請求書を生成します。
{
invoice_number: string;
reference: string;
currency_code: string;
recipient_email: string;
items: Array<{
name: string;
quantity: string;
unit_amount: {
currency_code: string;
value: string;
};
description?: string;
tax?: {
name: string;
percent: string;
};
}>;
note?: string;
terms_and_conditions?: string;
memo?: string;
payment_term?: {
term_type: 'DUE_ON_RECEIPT' | 'DUE_ON_DATE' | 'NET_10' | 'NET_15' | 'NET_30' | 'NET_45' | 'NET_60' | 'NET_90';
due_date?: string;
};
}支払いの作成
一括支払いを処理します。
{
sender_batch_header: {
sender_batch_id: string;
email_subject?: string;
recipient_type?: string;
};
items: Array<{
recipient_type: string;
amount: {
value: string;
currency: string;
};
receiver: string;
note?: string;
}>;
}エラー処理
サーバーは包括的なエラー処理を実装します。
入力検証: 具体的なメッセージによる詳細な検証エラー
PayPal API エラー: PayPal エラーの詳細を含む構造化されたエラー応答
ネットワーク エラー: 一時的なネットワークの問題に対する再試行ロジック
認証エラー: トークンの自動更新とエラーメッセージのクリア
レート制限: API レート制限のバックオフ戦略
セキュリティに関する考慮事項
すべての機密データは検証され、サニタイズされます
PayPalによるOAuth 2.0認証
環境変数による安全な資格情報管理
すべてのAPIパラメータの入力検証
エラーメッセージは機密情報を公開しません
発達
建物
npm run build開発モードで実行
npm run devテスト
npm testリンティング
npm run lint書式設定
npm run format貢献
リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを作成する
ライセンス
MITライセンス