Payment Intelligence

本地服务

github.com金融数据01 天前更新

代码仓库访问官网

关于 Payment Intelligence

Payment Intelligence 是面向支付运营、调查和迁移团队的离线 MCP 服务，用于处理 ISO 20022 消息。它可解释、脱敏和检查消息及标识符，只读取本地文件，不联网，也不附带机构参考数据。

主要功能

01解释 ISO 20022 支付消息
02对文件中的支付数据进行假名化
03检查 CBPR+ 准备情况和支付生命周期
04验证和生成 IBAN；检查 BIC
05验证 SSI 文件并核对支付路由

适用场景

01根据消息文件解释退回的支付
02分享支付批次前先进行脱敏
03依据机构 SSI 文件检查支付
04使用本地参考数据查询 BIC

MCP 相关

它作为本地 stdio MCP 服务运行，向 MCP 客户端提供支付消息、标识符、参考数据和 SSI 工具。它只会写入用户明确要求生成的脱敏文件。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "raafet57-payment-intelligence": {
      "command": "npx",
      "args": [
        "-y",
        "payment-intelligence-mcp"
      ]
    }
  }
}

启动命令npx -y payment-intelligence-mcp

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

安装包

npmpayment-intelligence-mcp0.3.2stdio

工具

收录的工具列表 · 更新于 5 天前

参数	类型	必填	说明
iban	string	是	IBAN，可带空格也可不带空格。

详细介绍

支付智能：面向 AI 助手的 ISO 20022 工具

面向支付运营、调查和迁移团队的离线 ISO 20022 工具，可用于 Claude Code、OpenAI Codex、GitHub Copilot、VS Code、Gemini CLI、Cursor 和任何 MCP 客户端。它基于与 Payment Intelligence Modules 浏览器套件相同的库构建。

所有数据都不会离开你的设备。 该插件通过 stdio 运行本地 MCP 服务。它不会发起网络调用、发送遥测数据，也不需要账户。它只会读取你指定的文件，并且只写入你要求生成的脱敏副本。

我们不提供参考数据。该插件可独立使用。 我们不会随附、出售或下载 SwiftRef、BIC Directory 或 SSI 数据。你的机构已经获得这些数据的许可；这些工具会在你的设备上读取你指定的文件：你自己的参考文件、自己的 SSI 文件和自己的支付消息。它不依赖特定供应商：

SWIFTRef 当前格式： 解压后的 BIC Directory 和 Payments Directory 文件夹（IDENTIFIERS，包括历史文件、PARTICIPANTS 和 RELATIONSHIPS 文件；布局从同一下载中的 STRUCTURES 文件读取）。
SWIFTRef 旧版产品： BIC Plus、BIC Directory 2018、Bank Directory Plus、IBAN Plus、SEPA routing、Reach Plus、gpi 和 SSI Plus。
任何其他供应商或内部系统： CSV/TSV 导出文件。系统会自动识别常见列名；column_map 可适配其他任何布局；无法映射的列会列在结果中，因此你不会被锁定在某一家数据供应商。

内置数据仅包括公开的格式规则：SWIFT IBAN 注册表结构、ISO 国家和货币代码，以及一小组 ISO 状态码和原因码。

你可以询问什么

“解释这条 pacs.008 / pacs.004 / camt.053。”
“在我把 payments/batch-0412.xml 发给供应商之前，先对它进行脱敏。”
“这笔付款为什么被退回？这是 pacs.008、pacs.002 和 pacs.004。”
“这是我们收到的 camt.110 和原始 pacs.008。对方在要求什么？问题是否已得到答复？”
“响应方在这条 camt.111 中确认了什么？”或“这些 Tracker 通知对我们的案件说明了什么？”
“DE89 3704 0044 0532 0130 00 是有效的 IBAN 吗？”或“用这些银行和账户号码生成一个法国 IBAN。”
“这条消息符合 CBPR+ 要求吗？”
“验证我们的 SSI 文件 ssi/master.tsv。”或“这条 pacs.009 是否通过我们 SSI 文件中的代理行向 Nova 付款？”
“在 ~/swiftref/2026-02 中的 BIC Directory 查找 DEUTDEFF。”或“排序代码 400501 对应哪个 BIC？”
“根据 Payments Directory RELATIONSHIPS 文件中的 SSI 检查这条 pacs.009。”

组件

类型	名称	功能
MCP 工具	`explain_payment_message`	为 pacs.008、pacs.009 和 camt.053 提供叙述说明；为 pacs.002、pacs.004、camt.052/054 和案例消息（camt.110/111、camt.056/029、较早版本的 camt.026/027/028/087、trck.003 和 trck.005 Tracker 消息）提供字段投影，并给出见解。
MCP 工具	`scrub_payment_message`	为各方、IBAN、账户、UETR 和参考编号生成一致的化名。文件到文件模式可避免原始内容进入聊天。
MCP 工具	`check_cbpr_readiness`	检查 AppHdr/Document 命名空间、架构配置文件覆盖范围、UETR、BIC 和 IBAN 提示。
MCP 工具	`analyze_payment_lifecycle`	将 ACK/NACK、pacs 和 camt 文件归入包含时间线和警告的线程。调查和取消消息会关联到其引用的付款。
MCP 工具	`decode_reason_code`	以通俗语言解释状态码和原因码（RJCT、AC01、MD07、……）。
MCP 工具	`validate_iban`	根据随附的 SWIFT IBAN Registry 快照检查国家、长度、BBAN 结构和 MOD-97。
MCP 工具	`build_iban`	根据 BBAN 字段生成 IBAN 并计算校验位。
MCP 工具	`check_bic`	检查 ISO 9362 语法和 ISO 3166 国家代码。使用你的参考文件时，还会查询 BIC：名称、位置、当前状态或是否已过期。
MCP 工具	`lookup_reference_data`	在你自己的参考文件中查询 BIC、国家清算代码和 LEI：记录、后继项、关联的国家 ID、服务参与情况。
MCP 工具	`validate_ssi_file`	检查 SSI 文件（SWIFTRef SSI Plus V3、Payments Directory RELATIONSHIPS、CSV 或 TSV）：格式、必填字段、日期、过时情况和冲突。
MCP 工具	`check_payment_against_ssi`	根据用户自有文件中的首选且生效的 SSI，检查 pacs.008 或 pacs.009（或明确指定的路线）。
技能	`explain-payment-message`	如何向操作员展示消息。
技能	`scrub-before-sharing`	文件到文件的脱敏工作流，绝不读取原始文件。
技能	`triage-payment-exception`	为失败的付款提供时间线、根本原因、修复方案和待解决问题，包括相关调查和取消案例。
技能	`check-payment-identifiers`	检查 IBAN 和 BIC，并提供恰当的注意事项。
技能	`check-ssi`	验证 SSI 文件并据此检查付款，绝不打开文件本身。
SSI 和参考工具会在本地读取你的文件，仅返回符合请求的记录，并屏蔽返回的所有账号。

为避免每次请求都指定参考文件夹的名称，请在启动 Agent 的 shell 中将 PAYMENT_INTELLIGENCE_REFERENCE_PATH 设置为该文件夹（例如 export PAYMENT_INTELLIGENCE_REFERENCE_PATH=~/swiftref/latest）。

只有 scrub_payment_message 会写入内容。它会将清理后的文件写入你指定的 output_path，拒绝覆盖已有文件，并且绝不会触碰原文件。

限制（依赖此工具前请先阅读）

CBPR+ 检查只是就绪情况提示。 它们不属于 MyStandards 使用规则验证。
未捆绑 BIC 目录。 没有你的参考文件时，BIC 检查仅验证语法和国家代码。有参考文件时，当前目录记录仍不能证明该机构能够处理某笔付款：服务参与情况、路由和双边关系需要分别检查。不要仅凭其中任何一项作出路由或合规决策。
使用完整的参考文件。 月度增量文件只列出变更，因此仅在增量文件中查询并不完整。工具会指出文件是否为增量文件。IBAN Plus 用于将国家 ID 关联到 BIC；IBAN 本身仍仅根据公开的 IBAN 注册机构结构进行验证。
有效的 IBAN 并不意味着账号存在。 此工具不提供收款人验证或账户持有人匹配功能。
没有实时追踪。 生命周期分析仅涵盖你提供的文件。没有 gpi、支付方案或结算查询功能。
只读取案件消息，不管理案件。 camt.110、camt.111、camt.056、camt.029、较旧的 camt.026、camt.027、camt.028 和 camt.087，以及 Swift Tracker 消息（trck.003 警报、trck.005 案件状态）会根据你的文件进行说明和串联。此插件未连接到 Swift Case Management，不保存案件状态，也不会起草、回复或关闭案件。它会提取相关字段供分流使用，但不会根据使用指南规则进行验证；MT 199 副本只会被读取，不会翻译。
经过假名化处理，而非匿名化。 清理后的输出仍可能受 GDPR 和类似法律视为个人数据。分享前请抽查。
原因代码列表是 ISO External Code Set 的精选子集。
SSI 检查的可靠性取决于你的 SSI 文件。 检查会验证格式和一致性，但不会确认 BIC 或账号是否存在，也不能取代与交易对手确认 SSI 变更。

安装

需要 Node.js 20.10 或更高版本。每个 Agent 都会从此存储库读取自己的清单。

Agent	安装
Claude Code	`/plugin marketplace add Raafet57/payment-intelligence-plugin`，然后运行 `/plugin install payment-intelligence@payment-intelligence`
OpenAI Codex（CLI、IDE）	`codex plugin marketplace add Raafet57/payment-intelligence-plugin`，然后运行 `codex plugin add payment-intelligence@payment-intelligence`
GitHub Copilot CLI	`copilot plugin marketplace add Raafet57/payment-intelligence-plugin`，然后运行 `copilot plugin install payment-intelligence@payment-intelligence`
VS Code（Agent 插件）	在 VS Code 中将同一存储库添加为插件市场，或使用下方的 npm 包作为 MCP 服务
Gemini CLI	`gemini extensions install https://github.com/Raafet57/payment-intelligence-plugin`
Cursor	Cursor Marketplace（收录后），或使用下方的 npm 包作为 MCP 服务
任何 MCP 客户端	运行 `npx -y [email protected]`，将其作为 stdio MCP 服务（此方式不包含技能）

然后启动新会话，尝试上面的请求之一。若要在没有自己的数据时进行试用，请使用 samples/ 中的示例消息。

构建方式

server/runtime/ 是简洁易读的 JavaScript，没有依赖项，也无需安装。每个 Agent 都通过 node 运行它。每个文件都由 Payment Intelligence Modules 浏览器套件的 TypeScript 源码生成，因此插件和 Web 应用共用同一份支付逻辑，并且每个文件都会注明其来源。

这些库是为浏览器编写的。runtime/dom-shim.mjs 使用未修改的 vendored @xmldom/xmldom 副本（MIT），为 Node 提供 DOMParser。
runtime/mcp.mjs 是一个手写的轻量 MCP 服务，通过 stdio 通信。它处理 initialize、tools/list 和 tools/call，并根据工具的输入架构检查每次工具调用。
evals/ 包含一个 claude plugin eval 测试套件（Claude Code 的评测运行器）。它会检查技能是否触发、是否调用了正确的工具（清理操作绝不会读取原始文件），以及无关请求是否不会触发插件。