PayPal Java MCP Server

PayPal Java MCP Server

site icon
2025.03.07 0
Java支付处理商户能力平台金融服务
PayPal Java MCP Server 是一个基于 Java 实现的 PayPal 商户能力平台(Merchant Capability Platform)服务器,主要用于分析和改进支付处理流程。它提供了 JSON-RPC over HTTP API 和 JSON-RPC over stdio 接口,支持多种工具和功能,包括授权率分析和基础计算器功能。
View on GitHub

Overview

基本能力

产品定位

PayPal Java MCP Server 是一个用于支付处理的商户能力平台,旨在帮助商户分析和改进支付授权率。

核心功能

  • JSON-RPC over HTTP API 用于 Web 客户端
  • JSON-RPC over stdio 接口用于 Smithery 集成
  • 授权率分析工具
  • 基础计算器功能

适用场景

  • 商户支付处理优化
  • 支付授权率分析
  • 支付系统集成

工具列表

  1. Authorization Rate Improvement Tool:分析交易数据并提供改进授权率的建议。
  2. 参数:merchantId(必填)、timeframe(可选)、transactionType(可选)
  3. Calculator Tool:执行基础数学运算。
  4. 参数:operation(必填)、a(必填)、b(必填)

常见问题解答

  1. 服务器工具列表无法访问
  2. 原因:可能尝试通过 HTTP 访问 stdio 模式运行的服务器。
  3. 解决方案:确保使用 JSON-RPC over stdio 接口,并添加 -Djsonrpc.stdio.interactive=true 启动参数。
  4. 非交互式环境中服务器初始化失败
  5. 解决方案:使用 start-non-interactive.sh 脚本。
  6. 服务器无响应
  7. 解决方案:检查服务器运行模式,验证 stdin/stdout 连接,查看日志文件。

使用教程

使用依赖

  • Java 17 或更高版本
  • Maven 3.6 或更高版本

安装教程

  1. 构建应用bash mvn clean package
  2. 运行 Web 模式(默认)bash java -jar target/paypal-java-mcp-server-0.0.1-SNAPSHOT.jar
  3. 运行 JSON-RPC over stdio 模式bash java -Dspring.profiles.active=stdio -Dspring.main.web-application-type=NONE -Djsonrpc.stdio.interactive=true -jar target/paypal-java-mcp-server-0.0.1-SNAPSHOT-stdio.jar

调试方式

  1. 健康检查bash curl http://localhost:8080/api/v1/health
  2. 使用计算器工具bash curl -X POST http://localhost:8080/api/v1/tools/calculate/execute \ -H "Content-Type: application/json" \ -d '{ "operation": "multiply", "a": 6, "b": 7 }'
  3. 测试 stdio 模式bash ./test-stdio.sh

许可证

该项目遵循 MIT 开源许可条款。