支付接口服务

HiPay MCP Server是一个实现模型上下文协议(MCP)的服务,提供对HiPay企业API的安全、标准化访问,支持交易管理和支付页面创建。

  • by hipay
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 hipay/hipay-mcp-server

使用说明

HiPay MCP服务器

这 HiPay MCP服务器 是一个 模型上下文协议(MCP) 实现桥梁 HiPay的企业API 具有对话或代理界面。
它目前可以安全、标准化地访问HiPay的 交易管理/咨询 和 付款页面创建 --全部通过单个MCP端点。


🚀 特性

  • 事务管理 –通过HiPay的V1和V3 API检索、更新或创建交易
  • 支付处理 –生成托管支付页面
  • 订单管理 –获取与特定订单关联的所有交易
  • 多环境支持 –与暂存和生产兼容
  • 安全认证 –使用用户名/密码凭据的基本身份验证
  • 符合MCP标准 –完全符合模型上下文协议标准

🧩 用法

命令行

# Using environment variables
export HIPAY_USERNAME="your_username"
export HIPAY_PASSWORD="your_password"
export HIPAY_ENVIRONMENT="stage"

npx @hipay/mcp-server --tools=transactions.get,transactions.update

# Using command-line arguments
npx @hipay/mcp-server   --tools=all   --username=your_username   --password=your_password   --environment=production

# Enable only specific tools
npx @hipay/mcp-server   --tools=transactions.get,transactions.update   --username=your_username   --password=your_password

🧰 可用工具

交易

  • transactions.get –按ID检索交易详细信息(V3 API)
  • transactions.getV1 –按ID检索交易详细信息(V1 API)
  • transactions.getByOrder –检索与订单关联的所有交易
  • transactions.update –更新交易(捕获、退款、接受等)

托管支付页面

  • hostedPaymentPages.create –创建托管支付页面

⚙️ 工具选择

您可以启用全部或部分工具:

选项 描述
--tools=all 启用所有可用工具
--tools=transactions.get,transactions.update 启用特定工具(逗号分隔)
(省略 --tools) 默认情况下启用所有工具

🌍 环境选项

值 描述
stage HiPay分期环境 (默认)
production HiPay生产环境

🔧 配置

环境变量

变量 描述 必填
HIPAY_USERNAME 嬉皮士API用户名 ✅
HIPAY_PASSWORD 支付宝API密码 ✅
HIPAY_ENVIRONMENT stage 或 production (默认值:stage) ❌

命令行参数

参数 描述
--tools 以逗号分隔的工具列表或 all
--username API用户名(覆盖env-var)
--password API密码(覆盖env-var)
--environment stage 或 production (默认值:stage)

🧱 先决条件

  • Node.js v18+
  • npm

💬 支持

对于问题或功能请求,请打开 GitHub问题.