Paypal MCP

🚀 PayPal MCP サーバー

DynamicEndpointsによって維持管理されているPayPal MCPサーバーです。このサーバーは、PayPalの決済機能を利用した様々な操作を容易に行うことができます。

🚀 クイックスタート

このセクションでは、PayPal MCPサーバーをすぐに起動するための手順を説明します。

📦 インストール

以下の手順に従って、サーバーをインストールしてください。

1. リポジトリをクローンします。

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 依存関係をインストールします。

   npm install
   

3. サーバーを起動します。

   node index.js
   

💻 使用例

基本的な使用法

注文の作成

const result = await mcpClient.useTool('paypal', 'create_order', {
  intent: 'CAPTURE',
  purchase_units: [{
    amount: {
      currency_code: 'USD',
      value: '100.00'
    },
    description: '高级订阅'
  }]
});

請求書の作成

const result = await mcpClient.useTool('paypal', 'create_invoice', {
  invoice_number: 'INV-2024-001',
  reference: 'REF-2024-001',
  currency_code: 'USD',
  recipient_email: 'customer@example.com',
  items: [{
    name: '咨询服务',
    quantity: '1',
    unit_amount: {
      currency_code: 'USD',
      value: '500.00'
    }
  }]
});

送金の処理

const result = await mcpClient.useTool('paypal', 'create_payout', {
  sender_batch_header: {
    sender_batch_id: 'PAY-2024_001',
    email_subject: '您已收到款项'
  },
  items: [{
    recipient_type: 'EMAIL',
    amount: {
      value: '1000.00',
      currency: 'USD'
    },
    receiver: 'employee@example.com',
    note: '月度工资支付'
  }]
});

📚 ドキュメント

エラー処理

このサーバーは、包括的なエラー処理を実装しています。

• 入力検証エラー（詳細なメッセージ付き）
• PayPal APIエラー（レスポンス詳細を含む）
• ネットワークおよび認証エラー
• レート制限とタイムアウトの処理

セキュリティに関する注意事項

• すべての機密データは検証およびクリーニングされます。
• PayPalのOAuth 2.0認証を使用します。
• セキュリティ資格情報は環境変数で管理されます。
• すべてのAPIパラメーターが検証されます。
• エラーメッセージは機密情報を漏洩しません。

開発

ビルド

npm run build

テスト

npm test

デバッグ

サーバーは詳細なログを出力して、デバッグを支援します。

• 認証問題
• API呼び出しの失敗
• 検証エラー
• リクエスト/レスポンスの詳細

貢献ガイド

1. リポジトリをフォークしてクローンします。

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 機能ブランチを作成します。

   git checkout -b feature/your-feature
   

3. 変更をコミットします。

   git add .
   git commit -m '添加新功能'
   

4. ブランチにプッシュします。

   git push origin feature/your-feature
   

5. プルリクエストを作成します。

📄 ライセンス

MITライセンスです。