MCP Server (deprecated)

🚀 MCP サーバー（非推奨）

このサーバーは、Model Context Protocol (MCP) を用いて PayPal API との完全な統合を提供します。標準化されたインターフェースを通じて、PayPal の支払い処理、請求書生成、定期購読管理、およびビジネス操作とのシームレスなやり取りを実現します。

✨ 主な機能

支払い処理

• 注文管理：注文の作成、更新、追跡
• 支払い処理：様々な支払い方法をサポート
• トークン化支払い：支払いトークンを使用した安全な後続の支払い
• 定期購読管理：定期的な支払いプランの作成と管理

ビジネス操作

• 商品カタログ：販売商品とサービスの追加と管理
• 請求書生成：専用の請求書を生成して送信
• 一括支払い：複数の受取人への大口振込を処理
• 特典活動：セールや割引イベントの設定と管理

🔧 技術詳細

サーバーサイド

• TypeScript で記述され、型安全性とコードの保守性を確保
• Express フレームワークをベースにした高性能 RESTful API
• PayPal SDK を統合した深い連携
• 環境変数を使用した機密設定情報の管理
• API の安定性を保証する組み込みエラー処理モジュール

クライアント

• 使いやすい開発者向けインターフェースを提供
• 複数のリクエスト形式（JSON、XML）をサポート
• API ドキュメントを自動生成し、利用を容易にする
• 開発プロセスを加速するサンプルコードを提供
• セキュリティを保証する完全な認証メカニズムを備える

🚀 クイックスタート

依存関係のインストール

npm install

サーバーの起動

npm start

設定ガイド

config.json ファイルを編集します：

{
  "port": 3000,
  "paypalClientId": "YOUR_CLIENT_ID",
  "paypalClientSecret": "YOUR_CLIENT_SECRET"
}

インターフェースドキュメント

すべての API エンドポイントには、リクエストパラメータ、レスポンス形式、およびサンプルを含む詳細なドキュメントが付属しています。

💻 使用例

注文の作成

POST /api/orders
Content-Type: application/json

{
  "amount": {
    "value": "100.00",
    "currency": "USD"
  },
  "description": "Example product"
}

支払いのキャプチャ

POST /api/payments/capture
Content-Type: application/json

{
  "order_id": "PAY-XXXXX",
  "payment_token": "TOKEN-XXXXX"
}

エラー処理

サーバー側では、多層的なエラー処理メカニズムを採用しています：

• 入力検証：すべてのリクエストパラメータを詳細にチェック
• 例外キャプチャ：すべての未処理の例外を記録
• リトライメカニズム：ネットワーク問題に対して自動的に再試行
• レート制限ポリシー：API の乱用を防止

セキュリティ対策

• すべての機密情報は暗号化されています
• OAuth 2.0 プロトコルを使用した認証
• データ転送の安全性を確保するための HTTPS の設定
• 定期的なセキュリティ監査と脆弱性の修復

開発ガイド

プロジェクトのビルド

npm run build

開発モードでの起動

npm run dev

テストの実行

npm test

コードの整形

npm run format

貢献ガイド

1. このリポジトリを Fork します
2. 機能ブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. Pull Request を提出します

📄 ライセンス

MIT License