Worldpay MCP 服务器

项目简介

Worldpay MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在简化 LLM 应用与 Worldpay 支付 API 的集成。它提供了一系列工具和资源，使开发者能够通过自然语言交互，利用 Worldpay API 进行支付处理、查询交易信息，并生成集成代码。

主要功能点

支付处理 (Make Payment): 允许通过 LLM 客户端调用工具发起支付交易。
支付查询 (Query Payments): 支持查询 Worldpay 支付交易记录，并以表格形式返回。
生成 Checkout 表单 (Generate Checkout Form): 根据用户选择的框架（Web 或 React），生成 Worldpay 支付 Checkout 表单代码，包含 HTML/React 组件、CSS 样式和 JavaScript 初始化代码。
生成支付服务器代码 (Generate Payment Server Code): 根据用户指定的支付方式、工具类型和编程语言，生成服务器端支付处理代码，目前支持 Node.js 环境下的卡支付会话模式。
生成支付查询文档 (Generate Payment Query): 提供 Worldpay 支付查询 API 的文档和示例，帮助用户理解和使用各种查询参数。
资源管理: 托管 Worldpay API 的 OpenAPI 规范、API schemas、API endpoints、使用指南和示例 JSON 数据等资源，方便 LLM 客户端获取和利用。

安装步骤

安装依赖: 在仓库根目录下运行以下命令安装项目依赖。
```
npm install
```
构建服务器: 运行以下命令构建服务器发行版本。
```
npm run build
```

服务器配置

stdio 服务器配置 (claude_desktop_config.json):

用于 Claude Desktop 等 MCP 客户端，通过标准输入/输出 (stdio) 协议通信。

{
    "mcpServers": {
        "worldpay": {
            "name": "worldpay-server",  // MCP 服务器名称，客户端配置中引用
            "command": "node",         // 启动服务器的命令
            "args": ["PATH TO server-stdio.js"], // 启动命令参数，指向编译后的 stdio 服务器入口文件
            "env": {                  // 环境变量配置
                "WORLDPAY_USERNAME": "YOUR_WORLDPAY_USERNAME", // Worldpay API 用户名，请替换为您的实际用户名
                "WORLDPAY_PASSWORD": "YOUR_WORLDPAY_PASSWORD"  // Worldpay API 密码，请替换为您的实际密码
            }
        }
    }
}

SSE 服务器配置 (环境变量):

用于 Cursor 等 MCP 客户端，通过 Server-Sent Events (SSE) 协议通信。

配置环境变量 'WORLDPAY_USERNAME' 和 'WORLDPAY_PASSWORD'，用于 Worldpay API 鉴权。

export WORLDPAY_USERNAME=YOUR_WORLDPAY_USERNAME  # Worldpay API 用户名，请替换为您的实际用户名
export WORLDPAY_PASSWORD=YOUR_WORLDPAY_PASSWORD  # Worldpay API 密码，请替换为您的实际密码

基本使用方法

stdio 服务器:

配置 'claude_desktop_config.json' 后，Claude Desktop 等 MCP 客户端会自动启动 stdio 服务器。

SSE 服务器:

确保已配置环境变量 'WORLDPAY_USERNAME' 和 'WORLDPAY_PASSWORD'。

运行以下命令启动 SSE 服务器 (默认端口 3001)。

node dist/server-sse.js

在支持 SSE 传输协议的 MCP 客户端中，配置连接到 'http://localhost:3001/sse' 以使用 Worldpay MCP 服务器的功能。

启动服务器后，您可以使用 MCP 客户端（如 Claude Desktop 或 Cursor）连接到该服务器，并利用其提供的工具和资源与 Worldpay API 进行交互。例如，您可以指示 LLM 客户端调用 'makePayment' 工具来发起支付，或使用 'queryPayments' 工具查询交易记录。您还可以利用服务器提供的 Prompt 模板，定制与 LLM 的交互模式，以更自然地完成支付相关的任务。

关键词