mcpField
M
mcp-niubiz

mcp-niubiz

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

关于 mcp-niubiz

@codespar/mcp-niubiz 是面向秘鲁卡收单机构 Niubiz 的 MCP 服务，实现电商支付流程中的安全令牌、结账会话、授权和同日冲正。卡号由 Niubiz 自有结账表单处理，不经过本服务器。

主要功能

  1. 01获取安全令牌，并自动缓存与刷新
  2. 02创建含金额与反欺诈数据的结账会话
  3. 03使用 transactionToken 完成授权
  4. 04同日撤销授权（冲正）

适用场景

  1. 01为秘鲁电商网站接入 Niubiz 三步支付流程
  2. 02对当日误操作的授权进行撤销

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-niubiz": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-niubiz"
      ],
      "env": {
        "NIUBIZ_USER": "<NIUBIZ_USER>",
        "NIUBIZ_PASSWORD": "<NIUBIZ_PASSWORD>",
        "NIUBIZ_MERCHANT_ID": "<NIUBIZ_MERCHANT_ID>",
        "NIUBIZ_ENV": "<NIUBIZ_ENV>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-niubiz
需要配置的环境变量
NIUBIZ_USER密钥Niubiz API user
NIUBIZ_PASSWORD密钥Niubiz API password
NIUBIZ_MERCHANT_IDMerchant id (código de comercio)
NIUBIZ_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.

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

安装包
npm@codespar/mcp-niubiz0.1.0

工具

4

收录的工具列表 · 更新于 2 周前

参数类型必填说明
forceboolean否即使已有缓存，也强制获取新令牌

详细介绍

@codespar/mcp-niubiz

Niubiz（前身为 VisaNet Perú）的 MCP 服务——秘鲁最大的银行卡收单机构，服务超过 30 万家商户。实现完整的电商流程：安全令牌 → 结账会话 → 授权，以及当日撤销。

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "niubiz": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-niubiz"],
      "env": {
        "NIUBIZ_USER": "your-api-user",
        "NIUBIZ_PASSWORD": "your-api-password",
        "NIUBIZ_MERCHANT_ID": "your-merchant-id",
        "NIUBIZ_ENV": "sandbox"
      }
    }
  }
}
Claude Code
claude mcp add niubiz --env NIUBIZ_USER=... --env NIUBIZ_PASSWORD=... --env NIUBIZ_MERCHANT_ID=... -- npx -y @codespar/mcp-niubiz
Cursor / VS Code

将相同的代码块添加到 .cursor/mcp.json 或 .vscode/mcp.json。

工具（4 个）

工具端点功能
get_security_tokenPOST /api.security/v1/securityBearer 令牌（缓存 20 分钟；其他工具会自动获取）
create_session_tokenPOST /api.ecommerce/v2/ecommerce/token/session/{merchantId}包含金额和反欺诈数据的结账会话
authorize_transactionPOST /api.authorization/v3/authorization/ecommerce/{merchantId}使用结账会话的 transactionToken 进行授权
reverse_transactionPOST /api.authorization/v3/reverse/ecommerce/{merchantId}当日撤销一笔授权

Niubiz 流程

银行卡数据不会经过此服务：客户在 Niubiz 自有的结账表单中输入卡信息（该表单由 create_session_token 提供），表单返回 transactionToken，然后 authorize_transaction 完成购买。这是 Niubiz 标准的三步电商集成流程。

身份验证

变量必填说明
NIUBIZ_USER是API 用户名
NIUBIZ_PASSWORD是API 密码
NIUBIZ_MERCHANT_ID是商户 ID（código de comercio）
NIUBIZ_ENV否sandbox（默认值）或 production

企业版

需要为 Agent 支付设置治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上添加策略引擎、支付路由和合规模板。

托管版

此开源服务使用你的凭据直接调用 Niubiz API。CodeSpar 托管版通过一个接口连接所有 LATAM 服务提供商，并提供自动故障转移、治理、审计和凭据保险库：codespar.dev/agents。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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