支付控制服务器

Agent-SafePay MCP Server是一个允许AI代理与支付控制系统交互的协议服务器,提供支付意图创建、提交同意、确认支付和审计日志查看等功能。

  • by Edidas02
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Edidas02/agent-safepay-mcp

使用说明

Agent-SafePay MCP 服务器

MCP(模型上下文协议)服务器适配,使AI代理能够与Agent-SafePay支付控件进行交互。

请参阅 https://github.com/Edidas02/agent-safepay-lite/blob/main/README.md 获取安装说明

可用工具

1. create_payment_intent

使用政策检查创建支付。

参数:

  • amount (数字):金额以分为单位(例如,2599表示25.99美元)
  • currency (字符串): "USD"(美元)、"EUR"(欧元)或 "GBP"(英镑)
  • merchant_id (字符串):商户ID(例如,“m_abc”)
  • merchant_name (字符串):商户显示名称
  • item_description (字符串):正在购买什么

返回值:

  • 支付意图ID
  • 状态: blocked, requires_consent,或 ready
  • 代理的下一步行动

2. submit_consent

提交一次性密码以获取同意批准。

参数:

  • intent_id (字符串):支付意图ID
  • otp (字符串):来自用户的6位一次性密码(OTP)

返回值:

  • 成功/失败状态

3. confirm_payment

执行支付。

参数:

  • intent_id (字符串):支付意图ID

返回值:

  • 支付结果(成功/失败)

4. get_audit_log

查看交易审计轨迹。

参数:

  • intent_id (字符串):支付意图ID

返回值:

  • HMAC签名的审计日志(ND-JSON格式)

示例代理流程

User: "Buy me a $30 gadget from Acme"

Agent: [calls create_payment_intent]
Response: "⚠️ This payment requires user consent.
          Ask the user to check their server logs for the OTP code."

User: "The OTP is 483927"

Agent: [calls submit_consent with OTP]
Response: "✅ Consent granted! Payment intent is now ready."

Agent: [calls confirm_payment]
Response: "✅ Payment successful!"

建筑学

AI Agent (Claude Desktop)
    ↓ MCP Protocol
MCP Server (this project)
    ↓ HTTP/JSON
Agent-SafePay API (:8080)
    ↓
Policy Engine + PSP Emulator