worldpay-mcp

🚀 简单的Worldpay APIs MCP服务器

这是一个简单的Worldpay APIs MCP（模型上下文协议）服务器，它通过实现模型上下文协议，能够创建和查询支付，为支付处理提供了便利。

🚀 快速开始

安装

npm install

构建服务器发行版

npm run build

配置

stdio

MCP stdio服务器使用claude_desktop_config.json文件进行配置，这是一个包含MCP服务器配置的JSON文件。

{
    "mcpServers": {
        "worldpay": {
            "name": "worldpay-server",
            "command": "node",
            "args": ["PATH TO server-stdio.js"],
            "env": {
                "WORLDPAY_USERNAME": "USERNAME",
                "WORLDPAY_PASSWORD": "PASSWORD"
            }
        }

sse

SSE服务器使用环境变量进行配置。

export WORLDPAY_USERNAME=USERNAME
export WORLDPAY_PASSWORD=PASSWORD

运行服务器

stdio

Claude会自动启动MCP stdio服务器。

sse

运行SSE服务器的命令如下：

node server-sse.js

✨ 主要特性

服务器版本

有两个版本的服务器：

• server-stdio.js - 一个使用stdio传输的简单服务器，已在Claude Desktop上测试过。
• server-sse.js - 使用SSE传输的服务器，已在Cursor上测试过。

工具

创建支付

查询支付

生成结账表单

generateCheckoutForm工具用于为在应用程序中集成Worldpay付款处理快速生成定制化的结账表单代码，支持Web和React框架。

• 参数：
  • checkoutId：您的Worldpay结账ID
  • framework：您使用的框架（web或react）
• 响应：该工具返回多个内容项，包括HTML/React组件代码、CSS样式表、JavaScript初始化代码（针对Web框架），提供了快速在应用程序中实现Worldpay结账表单所需的一切。

生成支付服务器代码

generatePaymentServerCode工具为通过Worldpay API处理付款提供服务器端代码，根据您的特定付款方式、仪器类型和编程语言生成代码。

• 参数：
  • method：付款方式（card，paypal）
  • instrument：仪器类型（plain，session）
  • language：编程语言（node，java）
• 响应：该工具返回服务器端实现代码和示例API响应供参考，目前支持使用会话令牌在Node.js中处理卡付款。

生成支付查询

generatePaymentQuery工具为查询Worldpay的Payment Queries API提供文档和示例，帮助您了解如何使用各种参数过滤和检索付款数据。

• 参数：
  • startDate：查询范围的起始日期（ISO 8601格式）
  • endDate：查询范围的结束日期（ISO 8601格式）
  • pageSize：要返回的最大结果数（可选，默认值为20）
  • currency：按货币代码过滤（可选）
  • minAmount：最小付款金额（可选）
  • maxAmount：最大付款金额（可选）
  • last4Digits：卡号的最后4位数字（可选）
  • entityReferences：商家实体引用（可选）
  • receivedEvents：付款事件类型（可选）
• 响应：该工具返回关于查询参数的全面文档、不同参数组合的示例API请求和示例API响应供参考。