Paypal Java MCP Server

🚀 PayPal Java 項目文檔

這是一個用於管理 PayPal 賬戶交易數據的 Java 項目。該項目提供了分析交易授權率和基礎數學運算兩大核心功能，同時支持 Docker 部署，方便快捷地搭建服務。

🚀 快速開始

本項目主要提供了兩個實用工具，分別為授權率分析工具和計算器工具，下面為你詳細介紹其使用方法。

授權率分析工具

此工具可對交易數據進行分析，並給出提高授權率的建議。 參數說明：

• merchantId（必需）：要分析的商戶 ID
• timeFrame（可選）：分析的時間範圍，默認為 "last_30_days"
• transactionType（可選）：交易類型篩選，默認為 "all"

計算器工具

該工具用於執行基礎數學運算。 參數說明：

• operation（必需）：要執行的運算，包括 add、subtract、multiply 和 divide
• a（必需）：第一個操作數
• b（必需）：第二個操作數

✨ 主要特性

• 提供授權率分析和基礎數學運算兩大功能模塊，滿足不同業務需求。
• 支持 Docker 部署，包含 REST API 服務器和 JSON - RPC 標準輸入輸出服務器的 Docker 鏡像構建與啟動。

📦 安裝指南

Docker 部署

本項目支持通過 Docker 進行部署，以下為你介紹具體的鏡像構建和容器啟動步驟。

構建 Docker 鏡像

使用 Docker Compose 構建兩個鏡像

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