HiPay MCP 服务器

HiPay MCP 服务器 是一个实现了 模型上下文协议（MCP） 的系统，它连接了 HiPay 企业API 和对话式或代理接口。目前，它通过单一的MCP端点提供了对HiPay 交易管理和查询 以及 支付页面创建 的安全、标准化访问。

---

🚀 功能

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

---

🧩 使用方法

命令行

# 使用环境变量
export HIPAY_USERNAME="your_username"
export HIPAY_PASSWORD="your_password"
export HIPAY_ENVIRONMENT="stage"

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

# 使用命令行参数
npx @hipay/mcp-server   --tools=all   --username=your_username   --password=your_password   --environment=production

# 启用特定工具
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	HiPay API 用户名	✅
HIPAY_PASSWORD	HiPay API 密码	✅
HIPAY_ENVIRONMENT	stage 或 production (默认：stage)	❌

命令行参数

参数	描述
--tools	工具的逗号分隔列表或 all
--username	API 用户名（覆盖环境变量）
--password	API 密码（覆盖环境变量）
--environment	stage 或 production (默认：stage)

---

🧱 先决条件

• Node.js v18+
• npm

---

💬 支持

对于问题或功能请求，请在GitHub Issues中提交。