AI导哈

支付管理服务器

Nexi XPay商户后台API的MCP服务器，支持AI助手查询订单、交易详情、警告/异常和支付方式。

  • by stucchi
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 stucchi/nexi-xpay-mcp-server

使用说明

nexi xpay mcp服务器

MCP服务器 Nexi XPay后台API。使AI助手（Claude、Cursor等）能够从您的Nexi XPay商家帐户查询订单、交易详细信息、警告/异常和支付方式。

工具

工具 说明
list_orders 列出带有过滤器的订单（日期范围、渠道、状态、交易代码）
order_details 特定交易的完整细节
warnings 检索警告/异常（默认值：过去7天）
payment_methods 列出商家的当前付款方式

先决条件

  • Python>=3.10
  • Nexi XPay商户账户，可访问后台API
  • API证书： 别名, API密钥 和 密钥 （来自Nexi后台）

安装

uvx nexi-xpay-mcp-server

在.mcp.json中的用法

添加到MCP配置文件(.mcp.json 对于克劳德代码， claude_desktop_config.json 克劳德桌面版）：

{
  "mcpServers": {
    "nexi": {
      "command": "uvx",
      "args": ["nexi-xpay-mcp-server"],
      "env": {
        "NEXI_ALIAS": "your_alias",
        "NEXI_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

多家商户

使用不同的密钥为每个商家运行一个实例：

{
  "mcpServers": {
    "nexi-acme": {
      "command": "uvx",
      "args": ["nexi-xpay-mcp-server"],
      "env": {
        "NEXI_ALIAS": "acme_merchant",
        "NEXI_SECRET_KEY": "acme_secret_key"
      }
    },
    "nexi-globex": {
      "command": "uvx",
      "args": ["nexi-xpay-mcp-server"],
      "env": {
        "NEXI_ALIAS": "globex_merchant",
        "NEXI_SECRET_KEY": "globex_secret_key"
      }
    }
  }
}

环境变量

变量 必填 默认 描述
NEXI_ALIAS 是 - 商户别名（也用作API密钥）
NEXI_SECRET_KEY 是 -- MAC计算密钥
NEXI_TEST 没有 false 设置为 true 使用测试环境

发展

git clone https://github.com/stucchi/nexi-xpay-mcp-server.git
cd nexi-xpay-mcp-server
uv sync

本地运行：

NEXI_ALIAS=your_alias NEXI_SECRET_KEY=your_secret uv run nexi-xpay-mcp-server

许可证

麻省理工学院

相关 MCP