Worldpay MCP

🚀 Worldpay APIs MCPサーバー

このプロジェクトは、Worldpay APIs MCP（モデルコンテキストプロトコル）を利用したシンプルな支払いサーバーです。モデルコンテキストプロトコルを実装し、支払いの作成と照会を行うことができます。

🚀 クイックスタート

このサーバーには2つのバージョンがあります。

• 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フレームワークの場合）を返します。
• 支払いサーバーコードの生成：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ファイルを使用して設定されます。

{
    "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