基于意图 — 代理创建支付意图,绝不直接执行支付
它为代理提供什么
一个专门为单个 MCP 连接设计的能力。
服务器拥有其领域逻辑,并发布 MCP 客户端可发现的工具契约。ADK-Rust 可将该契约加载到代理中,为所选模型提供者规范每个模式,并将连接生命周期保持在代理业务逻辑之外。
无直接执行 — 所有财务操作均通过策略评估和审批门控
i64金额 — 所有金额以最小单位(分/便士)计,无浮点,无舍入误差
无秘密 — 凭证保存在保险库引用中,工具参数或响应中不出现
幂等性 — 每个写操作需幂等键,防止重复操作
审计轨迹 — 每个操作记录执行者、理由和时间戳,确保合规
架构
MCP Payments 在代理系统中的作用。
模型无需了解服务器背后系统的实现细节或凭证。它看到审核过的工具定义。MCP 客户端负责发现和调用,服务器保持验证、策略和与领域系统的通信所有权。
ADK-Rust 代理
从审核过的工具目录中选择能力。
MCP 客户端
发现模式,发送调用,并接收类型化内容。
MCP Payments
验证请求并拥有 10 个已记录工具契约。
领域系统
维护服务器背后的 API、数据、凭证和业务规则。
来自项目文档
服务器发布的架构
工具目录
代理可以请求 MCP Payments 做什么?
每个工具都有稳定名称、易读的用途和 MCP 初始化时发现的 JSON 输入契约。风险类别来自项目的注册清单(如果有)。
10 个命名工具
lookup_payment按ID查询支付意图
read onlylist_customer_payments列出客户所有支付
read onlyget_payment_status获取支付意图当前状态
read onlycreate_checkout_intent创建结账支付意图(草稿)。金额>10000最小单位需审批。
internal writecreate_refund_intent为现有支付创建退款意图。方向=出账。
financial actioncreate_payout_intent创建付款意图。方向=出账。始终需审批。
financial actionrequest_payment_approval请求审批草稿支付意图。状态变更草稿→待审批。
internal writeexecute_approved_intent执行已审批支付意图。仅当状态=已审批时有效。
financial actionreconcile_payment对账支付与订单/发票引用。
internal writeattach_payment_evidence附加证据文件至支付意图,供审计轨迹使用。
internal write治理
了解每个工具的作用。
服务器连接继承其凭证和部署环境的权限。以下声明来自本项目的 README 和 MCP 注册清单;您的应用程序仍决定代理接收哪些工具以及何处需要批准。
- 执行者识别 — 每个写操作需执行者字段,标识发起者
- 理由记录 — 每个写操作需说明业务理由
- 幂等性 — 每个写操作需幂等键防止重复执行
- 金额阈值 — 结账意图金额超过10,000最小单位自动需审批
- 退款审批 — 所有退款需财务经理审批
- 付款审批 — 所有付款需财务经理和合规官审批
MCP 接口
当前文档声明的内容。
MCP 可传输工具、资源、提示、结构化结果、进度、取消和长时间运行的工作。此记录突出显示本仓库明确提及的现代协议特性。
安装并连接
遵循项目文档中的起点。
在拥有凭证和领域访问权限的环境中安装服务器。将其添加到您的 MCP 主机,验证发现的工具,并在交付生产代理前缩小工具集。
cargo install mcp-payments{
"mcpServers": {
"payments": {
"command": "mcp-payments",
"args": [],
"env": {}
}
}
}命令和配置从公开的 README 中提取。部署前请确认官方文档中的先决条件、环境变量和特定版本选项。
官方文档
继续使用项目维护者的权威信息源。
此页面提供服务器的易懂地图。仓库对确切的模式、先决条件、配置、示例、测试、版本和安全更新保持权威。
继续探索