pain001-mcp について
pain001-mcpは、ISO 20022決済ファイルを扱う金融チームやエージェント向けのMCPサーバーです。検証、生成、確認機能をpain001コアライブラリに委譲します。
主な機能
- 01決済ファイルの検証と生成
- 02決済データの確認
- 03決済識別子と移行への対応
- 04銀行レポートの解析とコーパスへのアクセス
活用シーン
- 01レビュー前のpain.001ファイル検証
- 02エージェントを介した決済XMLの生成
- 03決済記録と銀行レポートの確認
MCP 対応
MCPクライアントに決済関連ツールを提供し、デフォルトではstdioで起動します。オプションでHTTP/SSEトランスポートも利用できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
26掲載時のツール一覧 · 1 日前に更新
このツールにパラメーターはありません。
詳細
pain001-mcp
pain001 の検証、生成、検査機能を MCP ツールとして公開します。
目次
はじめに
pain001-mcp エコシステム
- pain001-mcp エコシステム — コアとこのコンパニオン
ライブラリリファレンス
- 機能一覧 — 現在の機能をテーマ別に紹介
- エコシステムの比較 — 簡易マトリックス。全表は
docs/COMPARISON.mdを参照してください - ベンチマーク — 主要な数値。全表は
docs/BENCHMARKS.mdを参照してください - 機能 — モジュールレベルの機能一覧
- 設定 — コアのオプション
- 例 — 実行可能な例の一覧
運用
- pain001-mcp を使用すべきでない場合 — 制限事項
- 開発 — make ターゲット、ファジング、CI
- セキュリティ — 保証とコンプライアンス
- ドキュメント — すべてのリファレンスドキュメント
- 安定性の保証 — SemVer の基準、出力の安定性、ツールチェーン最小要件の順守
- ライセンス
インストール
Python ライブラリとして
python -m pip install pain001-mcp
公開済みパッケージと開発ブランチは別個のものです。未リリースの
変更は、このコンパニオンの feat/v0.0.71 ブランチで、対応するコアの
ブランチと組み合わせてテストしてください。この作業に PyPI リリースや
バージョン更新は含まれません。
要件
Python 3.10 以降が必要です。CI では Linux 上で 3.10~3.14 をテストします。 ツールチェーンポリシーを参照してください。ディストリビューション付属のシステム Python に関する保証はありません。
クイックスタート
pain001-mcp --help
pain001-mcp
2 つ目のコマンドは stdio MCP サーバーを起動し、クライアントからの接続を待ちます。
クライアントで pain001-mcp を起動するように設定してください。オプションの
HTTP/SSE トランスポートについては、生成されたヘルプを使用してください。リスナーを公開する前に、ネットワークアクセスを保護してください。
pain001-mcp エコシステム
この独立してインストールするコンパニオンは、支払い処理をコアに委任します。 バージョンを連携して管理していても、ブランチの変更がリリース済みであることを意味するわけではありません。
| コンポーネント | 目的 | ユースケース |
|---|---|---|
| pain001 | 生成と検証 | 共通コントラクトと XML エンジン |
機能の概要
| 領域 | 機能 | 状態 |
|---|---|---|
| 統合 | 支払いの検証および生成ツール | テストで管理されており、新しいブランチでの作業は未リリースです |
エコシステムの比較
このマトリックスはリポジトリの対象範囲を示すものであり、競合製品との独立したベンチマーク比較ではありません。
| プロジェクト | 支払い XML の生成 | 実際の決済 | 合成銀行返信 |
|---|---|---|---|
| pain001-mcp | コアに委譲 | いいえ | 銀行サービスではありません |
根拠と完全なマトリックスについては、docs/COMPARISON.md をご覧ください。
ベンチマーク
CI ではベンチマークをスモークテストとして実行します。ハードウェアに依存しないスループットやレイテンシの保証はありません。測定値については、生成された実行レポートをご利用ください。
| シナリオ | 結果 | 環境 |
|---|---|---|
| アダプター操作 | 実行ごとに異なります | Python、ハードウェア、依存関係のバージョンを実行ごとに記録 |
手法と全結果については、docs/BENCHMARKS.md をご覧ください。
機能
信頼できるツールカタログは、サーバーから生成されます。検証、識別子、生成、移行、銀行レポートの解析、コーパスへのアクセス、および未リリースの suggest_record_fix ツールを網羅しています。提案は要確認です。財務項目については推測せず、修正を拒否します。未リリースのツールは、対応するコア機能ブランチでテストしてください。ツリー内のコア MCP は、これとは別の、より小さな範囲を対象としています。
設定
トランスポート、ホスト、ポートのオプションを確認するには、pain001-mcp --help を実行してください。デフォルトは stdio です。ツール数を転載するのではなく、リクエストの形式についてはツールカタログをご覧ください。
例
examples/ にある自己検証スクリプトを実行してください。テストでは、有効な入力と不正な入力、およびコアのコントラクトとの統合を網羅しています。
pain001-mcp を使用しない場合
銀行、決済エンジン、自律的な支払い承認システムではありません。使用前に出力を確認してください。トランスポートのサポートは、銀行による認定を意味しません。
開発
poetry install
poetry run make check
poetry run make security
poetry run python scripts/tool_catalogue.py --check
poetry run python scripts/render_readme.py --check
カバレッジの基準は、行カバレッジと分岐カバレッジが 100% であることです。CONTRIBUTING.md と DEVELOPMENT.md をご覧ください。README は正規のレイアウトと docs/readme-values.json から生成されます。CI は差異を検出すると拒否します。
セキュリティ
リクエストは信頼できないものとして扱ってください。HTTP リスナーを保護し、ログに実際のシークレットを含めないでください。ツールは、許可された入力パスを読み取る場合があります。修正処理で IBAN、BIC、金額、通貨が変更されることはありません。
脆弱性は SECURITY.md に従って報告してください。
ドキュメント
pain.001 とは? · ユーザーマニュアル · API リファレンス · 開発者ガイド · ファミリーマップ
安定性の保証
バージョンはコアと連携して 0.0.1 刻みで進みます。リリースはメンテナーが開始します。このブランチではバージョンを引き上げません。コントラクトと出力の変更には、互換性のレビューが必要です。これ以上のプラットフォームや安定性の保証を示唆するものではありません。
MCP レジストリ
mcp-name: io.github.sebastienrousseau/pain001-mcp
ライセンス
Apache-2.0 または MIT のデュアルライセンスで、どちらかを選択できます。LICENSE をご覧ください。依存関係には、それぞれ独自のライセンスが適用されます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。