Paypal Java MCP Server

🚀 PayPal Java プロジェクトドキュメント

このJavaプロジェクトは、PayPalアカウントの取引データを管理するためのものです。システムには、取引承認率の分析と基本的な数学演算ツールの2つの主要な機能モジュールがあります。

✨ 主な機能

承認率分析ツール

このツールは取引データを分析し、承認率を向上させるための提案を提供します。

パラメータ説明：

• merchantId（必須）：分析対象のマーチャントID
• timeFrame（任意）：分析の時間範囲。デフォルトは "last_30_days"
• transactionType（任意）：取引タイプのフィルター。デフォルトは "all"

計算機ツール

このツールは基本的な数学演算を実行するために使用されます。

パラメータ説明：

• operation（必須）：実行する演算。add、subtract、multiply、divideが含まれます
• a（必須）：最初の操作数
• b（必須）：2番目の操作数

Docker デプロイ

プロジェクトには、REST APIサーバーとJSON - RPC標準入出力サーバーのDockerサポートが含まれています。

Docker イメージの構築

Docker Composeを使用して2つのイメージを構築

docker-compose build

REST APIサーバーイメージを個別に構築

docker build --target rest-api -t paypal-mcp-rest-api .

JSON - RPCサーバーイメージを個別に構築

docker build -f Dockerfile.smithery -t paypal-mcp-jsonrpc .

Docker コンテナの起動

REST APIサーバーの起動

docker run -p 8080:8080 paypal-mcp-rest-api

JSON - RPCサーバーの起動

JSON - RPCサーバーは標準入出力でのやり取りを行うため、インタラクティブモードで実行する必要があります。

docker run -i paypal-mcp-jsonrpc

または、提供されているスクリプトを使用します。

./run-docker.sh

Docker Composeを使用した起動

REST APIサーバーを起動します。

docker-compose up rest-api

注意： JSON - RPC標準入出力サーバーは通常、標準入出力のやり取りが必要なため、Docker Composeで直接実行されません。

📚 詳細ドキュメント

トラブルシューティング

「サーバーのツールリストがネットワーク経由でアクセスできません」

サーバーのツールリストがネットワーク接続を介してアクセスできないというエラーメッセージが表示される場合、以下の理由が考えられます。

1. HTTPプロトコルを使用してサーバーにアクセスしようとしているが、サーバーが標準入出力モードで実行されている
2. サーバーがインタラクティブモードで起動されていない
3. 起動コマンドに -Djsonrpc.stdio.interactive=true フラグが含まれていない

解決策：

• JSON - RPC標準入出力インターフェースを使用することを確認する
• Dockerを使用する場合は、インタラクティブモードでサーバーを実行する（-i フラグを追加）
• 起動コマンドに -Djsonrpc.stdio.interactive=true フラグを追加する
• 非インタラクティブ環境では、start - non - interactive.sh スクリプトを使用する

「サーバーが非インタラクティブ環境で初期化できません」

サーバーが非インタラクティブ環境で正常に起動しない場合：

1. 専用の start - non - interactive.sh スクリプトを使用する
2. 起動コマンドに -Djsonrpc.stdio.interactive=false フラグを追加する
3. Dockerコンテナに正しいリソース権限が設定されていることを確認する

解決策：

./start-non-interactive.sh

「データベースに接続できません」

データベースに接続できないというエラーメッセージが表示された場合は、以下の点を確認してください。

1. データベースサービスが起動しているかどうか
2. データベース接続パラメータ（アドレス、ポート、ユーザー名、パスワードなど）が正しく設定されているかどうか
3. ネットワーク接続に異常がないかどうか

解決策：

# データベースサービスを再起動する
sudo systemctl restart postgresql

# データベースのリスニングアドレス設定を確認する
vi /etc/postgresql/main.conf

📄 ライセンス

このプロジェクトはApache License, Version 2.0を使用しています。詳細なライセンス内容については、LICENSE ファイルを参照してください。

# ライセンス契約の内容を表示する
cat LICENSE