简介

这是一个简单的Worldpay APIs MCP（模型上下文协议）服务器。

它实现了模型上下文协议来创建和查询支付。

有两个版本的服务器：

• server-stdio.js - 一个使用stdio传输的简单服务器。
• server-sse.js - 使用SSE传输的服务器。

_stdio_版本已在Claude Desktop上测试过。

_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响应供参考

安装

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