payfast

payfast-mcp

PayFast（南アフリカを代表する決済ゲートウェイ）向けのModel Context Protocol（MCP）サーバーです。Claude などの AI アシスタントが、PayFast の加盟店アカウントを安全に操作できるようにします。

機能

• 取引管理 — 取引の詳細取得、履歴の照会、トークン化された決済の処理
• サブスクリプション管理 — サブスクリプションの詳細取得、一時停止、再開、キャンセル、更新、臨時請求
• 返金処理 — 返金の作成（全額または一部）と返金状況の照会
• クレジットカード照会 — クレジットカード取引の詳細を検索
• サンドボックス対応 — 安全にテストできるよう、デフォルトでサンドボックスモードを使用
• セキュリティを重視した設計 — 認証情報は環境変数のみで設定し、機密データはログに記録されません

利用可能なツール

ツール	説明	リスク
ping	API 接続をテスト	低
transaction_fetch	ID で取引を取得	低
transaction_history	取引履歴を照会	低
transaction_charge	保存済みトークンで請求	中
subscription_fetch	サブスクリプションの詳細を取得	低
subscription_pause	サブスクリプションを一時停止	高
subscription_unpause	サブスクリプションを再開	中
subscription_cancel	サブスクリプションをキャンセル	高
subscription_update	サブスクリプションの条件を更新	高
subscription_adhoc	サブスクリプションの臨時請求	高
refund_create	返金を処理	高
refund_fetch	返金の詳細を取得	低
creditcard_fetch	カード取引を照会	低

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

クイックスタート

前提条件

• Node.js 18+
• PayFast の加盟店アカウント（サンドボックスまたは本番環境）

インストール

npm install -g payfast-mcp

または、npx で直接実行します。

npx payfast-mcp

設定

次の環境変数を設定します。

変数	必須	説明
PAYFAST_MERCHANT_ID	はい	PayFast の加盟店 ID
PAYFAST_MERCHANT_KEY	はい	PayFast の加盟店キー
PAYFAST_PASSPHRASE	はい	PayFast API のパスフレーズ
PAYFAST_ENVIRONMENT	いいえ	sandbox（デフォルト）または production

作業ディレクトリに .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"

開発

# Clone the repo
git clone https://github.com/jpbester/payfast-mcp.git
cd payfast-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run with MCP Inspector
npm run inspect

ライセンス

MIT