Payfast MCP

🚀 payfast-mcp

這是一個適用於南非領先支付網關 PayFast 的 模型上下文協議 (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