mcpField
N
Nexi XPay

Nexi XPay

本地服务
github.com/stucchi金融数据035 周前更新
代码仓库

关于 Nexi XPay

Nexi XPay 的 MCP 服务，将商户后台 API 接入 AI 助手，可查询订单、交易、异常和支付方式。

主要功能

  1. 01按日期、渠道和状态筛选订单
  2. 02查询交易详情
  3. 03获取警告与异常
  4. 04列出启用的支付方式
  5. 05支持配置多个商户实例

适用场景

  1. 01检查特定时段的订单
  2. 02查看交易详细信息
  3. 03排查近期支付异常
  4. 04核对商户启用的支付方式

MCP 相关

该服务向 MCP 客户端提供 Nexi XPay 后台 API 工具，用于查询订单、交易详情、警告和支付方式。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "stucchi-nexi-xpay": {
      "command": "uvx",
      "args": [
        "nexi-xpay-mcp-server"
      ]
    }
  }
}
启动命令uvx nexi-xpay-mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypinexi-xpay-mcp-server1.2.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

nexi-xpay-mcp-server

MCP PyPI License: MIT

用于 Nexi XPay Back Office APIs 的 MCP 服务。让 AI 助手（Claude、Cursor 等）能够查询 Nexi XPay 商户账户中的订单、交易详情、警告/异常情况和支付方式。

工具

工具描述
list_orders按筛选条件列出订单（日期范围、渠道、状态、交易代码）
order_details特定交易的完整详情
warnings获取警告/异常情况（默认：最近 7 天）
payment_methods列出商户的有效支付方式

前提条件

  • Python >= 3.10
  • 拥有 Back Office API 访问权限的 Nexi XPay 商户账户
  • API 凭据：Alias、API Key 和 Secret Key（来自 Nexi Back Office）

安装

uvx nexi-xpay-mcp-server

在 .mcp.json 中使用

将以下内容添加到 MCP 配置文件中（Claude Code 使用 .mcp.json，Claude Desktop 使用 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

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。