简介

这是一个用于 Worldpay API 的简单 MCP 服务器。

它实现了 Model Context Protocol 来进行和查询支付。

服务器有两个版本：

• 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": ["server-stdio.js 的路径"],
            "env": {
                "WORLDPAY_USERNAME": "用户名",
                "WORLDPAY_PASSWORD": "密码"
            }
        }

sse

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

export WORLDPAY_USERNAME=用户名
export WORLDPAY_PASSWORD=密码

运行服务器

stdio

Claude 将自动启动 stdio 服务器。

sse

启动服务器，默认为端口 3001。

node dist/server-sse.js