mcpField
P
pain001-mcp

pain001-mcp

本地服务
github.com/sebastienrousseau金融数据11 天前更新
代码仓库

关于 pain001-mcp

pain001-mcp 是面向金融团队和 Agent 的 ISO 20022 支付文件 MCP 服务，将验证、生成和检查功能交由 pain001 核心库处理。

主要功能

  1. 01验证和生成支付文件
  2. 02检查支付数据
  3. 03处理支付标识符与迁移
  4. 04解析银行报告并访问语料库

适用场景

  1. 01审核前验证 pain.001 文件
  2. 02通过 Agent 生成支付 XML
  3. 03检查支付记录和银行报告

MCP 相关

它向 MCP 客户端提供支付相关工具，默认通过 stdio 启动，也支持可选的 HTTP/SSE 传输。

配置

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

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

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

安装包
pypipain001-mcp0.0.75

工具

26

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

此工具无需参数。

详细介绍

pain001-mcp 标志

pain001-mcp

将 pain001 验证、生成和检查功能作为 MCP 工具提供。

构建 软件包注册表 文档 OpenSSF 评分卡 许可证：Apache-2.0 OR MIT Python 3.10 或更高版本

pain001-mcp 演示

目录

快速入门

pain001-mcp 生态系统

库参考

运维

安装

作为 Python 库
python -m pip install pain001-mcp

已发布的软件包与开发分支相互独立。请在此配套程序的 feat/v0.0.71 分支上，针对匹配的核心分支测试尚未发布的更改。本次工作不涉及 PyPI 发布或版本号升级。

要求

Python 3.10 或更高版本。CI 在 Linux 上测试 Python 3.10–3.14。请参阅 工具链政策；本文不声称支持发行版自带的系统 Python。

快速开始

pain001-mcp --help
pain001-mcp

第二条命令会启动 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 Registry

mcp-name: io.github.sebastienrousseau/pain001-mcp

许可证

根据 Apache-2.0 或 MIT 双重许可，由你选择。请参阅 LICENSE。依赖项保留各自的许可证。

评论

支持 Markdown

第一次接触 MCP？

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

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