Worldpay MCP

🚀 簡單的Worldpay APIs MCP服務器

這是一個簡單的Worldpay APIs MCP（模型上下文協議）服務器，可實現模型上下文協議來創建和查詢支付。服務器有兩個版本，server-stdio.js使用stdio傳輸，已在Claude Desktop上測試；server-sse.js使用SSE傳輸，已在Cursor上測試。

🚀 快速開始

安裝

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

✨ 主要特性

工具功能

創建支付

查詢支付

生成結賬表單

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響應供參考。