Payfast MCP

🚀 payfast-mcp

このプロジェクトは、南アフリカを代表する支払いゲートウェイである PayFast 用の Model Context Protocol (MCP) サーバーです。Claude などのAIアシスタントがPayFastのマーチャントアカウントと安全にやり取りできるようにします。

✨ 主な機能

• 取引管理 — 取引詳細の取得、取引履歴の照会、トークン化された請求の処理
• サブスクリプション管理 — サブスクリプションの取得、一時停止、再開、キャンセル、更新、および臨時請求
• 返金処理 — 返金（全額または部分）の作成と返金ステータスの照会
• クレジットカード照会 — クレジットカードの取引詳細の照会
• サンドボックスサポート — 安全なテストのためにデフォルトでサンドボックスモードに設定されています
• セキュリティ設計 — 環境変数を通じてのみ資格情報を管理し、機密データをログに残しません

📦 利用可能なツール

高リスクの操作は、実行前に人間の承認が必要です。

🚀 クイックスタート

前提条件

• Node.js 18+
• PayFastマーチャントアカウント（サンドボックスまたは本番環境）

インストール

npm install -g payfast-mcp

または、npxで直接実行することもできます。

npx payfast-mcp

設定

以下の環境変数を設定してください。

作業ディレクトリに .env ファイルを作成することもできます。

Claude Desktop

Claude Desktopの設定ファイル (claude_desktop_config.json) に追加します。

{
  "mcpServers": {
    "payfast": {
      "command": "npx",
      "args": ["-y", "payfast-mcp"],
      "env": {
        "PAYFAST_MERCHANT_ID": "your-merchant-id",
        "PAYFAST_MERCHANT_KEY": "your-merchant-key",
        "PAYFAST_PASSPHRASE": "your-passphrase",
        "PAYFAST_ENVIRONMENT": "sandbox"
      }
    }
  }
}

Claude Code

Claude Codeの設定に追加します。

claude mcp add payfast \
  -e PAYFAST_MERCHANT_ID=your-merchant-id \
  -e PAYFAST_MERCHANT_KEY=your-merchant-key \
  -e PAYFAST_PASSPHRASE=your-passphrase \
  -e PAYFAST_ENVIRONMENT=sandbox \
  -- npx -y payfast-mcp

Cursor

CursorのMCP設定ファイル（プロジェクトレベルの場合は .cursor/mcp.json、グローバルの場合は ~/.cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "payfast": {
      "command": "npx",
      "args": ["-y", "payfast-mcp"],
      "env": {
        "PAYFAST_MERCHANT_ID": "your-merchant-id",
        "PAYFAST_MERCHANT_KEY": "your-merchant-key",
        "PAYFAST_PASSPHRASE": "your-passphrase",
        "PAYFAST_ENVIRONMENT": "sandbox"
      }
    }
  }
}

Codex

Codex CLIを通じて追加します。

codex mcp add payfast \
  --env PAYFAST_MERCHANT_ID=your-merchant-id \
  --env PAYFAST_MERCHANT_KEY=your-merchant-key \
  --env PAYFAST_PASSPHRASE=your-passphrase \
  --env PAYFAST_ENVIRONMENT=sandbox \
  -- npx -y payfast-mcp

または、~/.codex/config.toml に直接追加することもできます。

[mcp_servers.payfast]
command = "npx"
args = ["-y", "payfast-mcp"]

[mcp_servers.payfast.env]
PAYFAST_MERCHANT_ID = "your-merchant-id"
PAYFAST_MERCHANT_KEY = "your-merchant-key"
PAYFAST_PASSPHRASE = "your-passphrase"
PAYFAST_ENVIRONMENT = "sandbox"

💻 開発

# リポジトリをクローン
git clone https://github.com/jpbester/payfast-mcp.git
cd payfast-mcp

# 依存関係をインストール
npm install

# ビルド
npm run build

# テストを実行
npm test

# MCPインスペクターで実行
npm run inspect

📄 ライセンス

MIT