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