基本能力
产品定位
Comax Payment Link MCP是一个专为Comax ERP/支付系统设计的集成服务,旨在简化支付链接创建、订单管理和客户信息检索流程。
核心功能
- Comax集成:提供与Comax系统交互的关键操作工具。
- FastMCP核心功能:
- 使用Zod模式验证的简单工具定义 - 会话管理 - 日志记录和错误处理 - 可配置的SSE远程通信 - 默认启用的CORS - 进度通知(适用于长时间运行的工具) - 类型化的服务器事件 - 用于测试和调试的CLI
适用场景
- 电子商务平台的支付链接生成
- 订单状态跟踪和管理
- 客户信息查询和管理
- 订单PDF链接生成
- 订单状态更新
工具列表
create_comax_payment_link:创建Comax订单并返回支付链接update_comax_order_payment:更新Comax订单支付确认get_comax_customer_details:通过CustomerID获取Comax客户详细信息get_comax_order_status:通过DocNumber或Reference获取Comax订单状态get_comax_order_details:获取Comax订单的详细信息get_comax_order_pdf_link:获取Comax订单的PDF链接set_comax_order_status:设置Comax订单状态get_comax_orders_by_credit_card:获取与信用卡号关联的订单get_comax_orders_simple:根据日期范围和可选过滤器检索订单chk_item_exists_in_orders:检查特定项目是否存在于订单中set_comax_order_self_pickup:标记Comax订单为自取
使用教程
使用依赖
确保已安装Node.js和pnpm(或npm/yarn)。
# 克隆仓库(如果尚未克隆)
# git clone
# cd
# 安装依赖
pnpm install安装教程
- 克隆仓库
- 安装依赖
- 配置必要的Comax API凭证和ID(在
src/index.ts中硬编码或通过环境变量配置)
调试方式
使用mcp-cli测试
npx fastmcp dev src/index.ts使用MCP Inspector检查
npx fastmcp inspect src/index.ts通过网络运行SSE
修改src/index.ts中的server.start配置,然后运行:
npx tsx src/index.ts