payfast

Name: payfast
Author: jpbester

本地服务

github.com/jpbester金融数据138 周前更新

代码仓库

关于 payfast

payfast 是面向 PayFast 商户账户的 MCP 服务，供 AI 助手执行支付管理操作。它涵盖交易、订阅和退款，并要求高风险操作经过人工批准。

主要功能

01获取交易详情并查询历史
02扣取已保存的支付令牌
03管理订阅
04创建退款并查询状态
05查询信用卡交易
06沙盒模式与审批机制

适用场景

01查看商户交易历史
02暂停或更新订阅
03办理全额或部分退款
04在沙盒中测试支付操作

MCP 相关

向 MCP 客户端提供 PayFast 交易、订阅、退款和银行卡查询工具。高风险操作需要人工批准。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "jpbester-payfast": {
      "command": "npx",
      "args": [
        "-y",
        "payfast-mcp"
      ],
      "env": {
        "PAYFAST_MERCHANT_ID": "<PAYFAST_MERCHANT_ID>",
        "PAYFAST_MERCHANT_KEY": "<PAYFAST_MERCHANT_KEY>",
        "PAYFAST_PASSPHRASE": "<PAYFAST_PASSPHRASE>",
        "PAYFAST_ENVIRONMENT": "<PAYFAST_ENVIRONMENT>"
      }
    }
  }
}

启动命令npx -y payfast-mcp

需要配置的环境变量

PAYFAST_MERCHANT_IDYour PayFast merchant ID

PAYFAST_MERCHANT_KEY密钥Your PayFast merchant key

PAYFAST_PASSPHRASE密钥Your PayFast API passphrase

PAYFAST_ENVIRONMENTPayFast environment: 'sandbox' or 'production' (defaults to sandbox)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmpayfast-mcp1.0.1stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

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