🚀 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