mcpField
P
Payment Intelligence

Payment Intelligence

ローカル
github.com金融データ01 日前に更新
リポジトリ公式サイト

Payment Intelligence について

Payment Intelligenceは、ISO 20022メッセージを扱う決済運用・調査・移行チーム向けのオフラインMCPサーバーです。ローカルファイルを使ってメッセージや識別子を説明・仮名化・検査し、ネットワーク通信や機関参照データの同梱はありません。

主な機能

  1. 01ISO 20022決済メッセージの説明
  2. 02ファイル内の決済データの仮名化
  3. 03CBPR+対応状況と決済ライフサイクルの確認
  4. 04IBANの検証・生成とBICの確認
  5. 05SSIファイルの検証と決済経路の照合

活用シーン

  1. 01メッセージファイルから返金理由を説明
  2. 02共有前に決済バッチを仮名化
  3. 03機関のSSIファイルに基づく決済確認
  4. 04ローカル参照データによるBIC検索

MCP 対応

ローカルのstdio MCPサーバーとして動作し、決済メッセージ、識別子、参照データ、SSIのツールをMCPクライアントに公開します。ユーザーが明示的に指定した仮名化ファイルのみを書き出します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの 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.2

ツール

11

掲載時のツール一覧 · 5 日前に更新

パラメーター型必須説明
ibanstringはいIBAN。空白の有無は問いません。

詳細

Payment Intelligence：AI アシスタント向け ISO 20022 ツール

決済業務、調査、移行チーム向けのオフライン ISO 20022 ツールです。Claude Code、OpenAI Codex、GitHub Copilot、VS Code、Gemini CLI、Cursor、およびあらゆる MCP クライアントで利用できます。Payment Intelligence Modules のブラウザースイートと同じライブラリを基盤としています。

データがマシンの外に出ることはありません。 プラグインはローカルの MCP サーバーを stdio 経由で実行します。ネットワークへの接続、テレメトリーの送信、アカウントの作成は一切行いません。指定したファイルのみを読み取り、依頼されたサニタイズ済みコピーのみを書き込みます。

参照データは提供していません。プラグインはお客様自身のデータを使用します。 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 Registry の構造、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 にルーティングされますか？」
  • 「この pacs.009 を、Payments Directory の RELATIONSHIPS ファイルにある SSI と照合してください。」

コンポーネント

種類名前機能
MCP ツールexplain_payment_messagepacs.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_readinessAppHdr/Document の名前空間、スキーマプロファイルの適用状況、UETR、BIC、IBAN に関するヒントを確認します。
MCP ツールanalyze_payment_lifecycleACK/NACK、pacs、camt ファイルを、タイムラインと警告を含むスレッドにまとめます。照会と取消は、引用元の支払いに関連付けられます。
MCP ツールdecode_reason_codeステータスコードと理由コード（RJCT、AC01、MD07、…）を平易な言葉で説明します。
MCP ツールvalidate_ibanバンドルされた SWIFT IBAN Registry のスナップショットを使って、国、桁数、BBAN 構造、MOD-97 をチェックします。
MCP ツールbuild_ibanBBAN のフィールドから IBAN を作成し、チェックデジットを計算します。
MCP ツールcheck_bicISO 9362 の構文と ISO 3166 の国コードをチェックします。参照ファイルがある場合は、BIC の名称、所在地、現行または失効の状態も照会します。
MCP ツールlookup_reference_data独自の参照ファイルから、BIC、国内クリアリングコード、LEI を照会します。レコード、後継情報、関連付けられた国内 ID、サービスへの参加状況を確認できます。
MCP ツールvalidate_ssi_fileSSI ファイル（SWIFTRef SSI Plus V3、Payments Directory RELATIONSHIPS、CSV、TSV）の形式、必須フィールド、日付、古さ、競合をチェックします。
MCP ツールcheck_payment_against_ssipacs.008 または pacs.009（あるいは明示的な経路）を、ユーザー自身のファイルにある優先度が最も高く、有効な SSI と照合します。
スキルexplain-payment-messageオペレーターへのメッセージの提示方法を説明します。
スキルscrub-before-sharing元ファイルを読み取らずに行う、ファイル間のスクラブ処理ワークフローです。
スキルtriage-payment-exception失敗した支払いについて、調査および取消のケースを含め、タイムライン、根本原因、修正方法、未解決の質問をまとめます。
スキルcheck-payment-identifiers適切な注意事項を添えて、IBAN と BIC をチェックします。
スキルcheck-ssiSSI ファイルを開かずに検証し、それらのファイルに照らして支払いをチェックします。
SSI ツールと参照ツールはファイルをローカルで読み込み、リクエストに一致するレコードのみを返し、返されるすべての口座番号をマスキングします。

リクエストのたびに参照フォルダーを指定せずに済むよう、エージェントを起動するシェルで 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 でも、口座が存在するとは限りません。 受取人確認（Verification of Payee）や口座名義人の照合はありません。
  • リアルタイムの追跡はありません。 ライフサイクル分析の対象は、提供されたファイルのみです。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 以降が必要です。各エージェントは、このリポジトリから独自のマニフェストを読み込みます。

エージェントインストール
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 CLIcopilot plugin marketplace add Raafet57/payment-intelligence-plugin を実行し、続けて copilot plugin install payment-intelligence@payment-intelligence を実行します。
VS Code（エージェントプラグイン）VS Code で同じリポジトリをプラグインマーケットプレイスとして追加するか、以下の npm パッケージを MCP サーバーとして使用します。
Gemini CLIgemini extensions install https://github.com/Raafet57/payment-intelligence-plugin を実行します。
CursorCursor マーケットプレイス（掲載後）、または以下の npm パッケージを MCP サーバーとして使用します。
任意の MCP クライアントnpx -y [email protected] を stdio MCP サーバーとして実行します（この方法ではスキルは含まれません）。

新しいセッションを開始し、上記のリクエストのいずれかを試してください。独自のデータを使わずに試すには、samples/ のサンプルメッセージを使用してください。

構成

server/runtime/ は依存関係がなく、インストール手順も不要な、読みやすいプレーンな JavaScript です。各エージェントは node で実行します。各ファイルは Payment Intelligence Modules ブラウザースイートの TypeScript ソースから生成されるため、プラグインとウェブアプリは決済ロジックを共有し、各ファイルには元のソースが記載されています。

  • ライブラリはブラウザー向けに作成されています。runtime/dom-shim.mjs は、変更を加えていない @xmldom/xmldom（MIT）のベンダーコピーを使い、Node に DOMParser を提供します。
  • runtime/mcp.mjs は、stdio 上で動作する手書きの小規模な MCP サーバーです。initialize、tools/list、tools/call を処理し、すべてのツール呼び出しをツールの入力スキーマに照らして検証します。
  • evals/ には、claude plugin eval スイート（Claude Code の評価ランナー）が含まれています。スキルが起動すること、適切なツールが呼び出されること（スクラビングでは元のファイルを読み取らないこと）、無関係なリクエストにはプラグインが反応しないことを確認します。

ライセンス

MIT。詳しくは LICENSE を参照してください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。