Zen7-Payment-Agent MCP Server

官方

Zen7 Payment Agent是DePA（去中心化支付代理）的首个实现项目，开创了下一代智能支付基础设施。

GitHub
176

文档

Zen7 支付代理

License Python Built with uv 中文版本

实时进度更新可在 实时进度 页面查看 关于 x402 协议的支持，请点击此处

Zen7 支付代理是 DePA（去中心化支付代理）的首个实践落地项目，开创了下一代智能支付基础设施。它不仅完整实现了 DePA 的核心功能，还在代理商务领域成功部署了创新应用案例。

作为 DePA 生态中的首个实践项目，Zen7 实现了多项关键特性：代理间的自动化加密支付、“免许可授权”机制，以及基于大语言模型的意图识别与交互。

Zen7 支付代理采用多代理协作架构，同时支持 A2A 和 MCP 协议，以及托管和非托管支付模式。它为 AI 代理和原生 Dapp 应用提供了全面的支付解决方案，具备多链、多币种、多钱包支持、高频交易、免 Gas 操作和无密码认证等能力。

Zen7 Payment Agent Architecture

仓库导航

本仓库包含 Zen7 支付代理的完整实现，展示了基于 Zen7 支付代理（去中心化支付代理）协议的核心组件与架构设计。

核心目录结构

项目的核心实现位于以下关键目录：

host_agent - 多代理协作架构的核心实现。主代理使用 gemini-2.0-flash-lite 模型作为核心协调器，负责查询理解、状态管理和响应协调。子代理系统（sub_agents/）包含五个专用代理：payer_agent 处理付款方的订单创建、EIP-712 签名生成和钱包余额验证；settlement_agent 专注于结算流程，确认支付详情、执行链上交易并监控交易状态；payee_agent 处理收款方相关操作，接收结算通知、确认订单创建并通知支付完成；order_agent 管理订单处理和意图识别，自动路由到不同的代理；allowance_agent 提供授权额度查询功能，支持多链代币授权查询。

a2a_server 和 mcp_server - 协议适配层实现，提供多样化的集成方式。a2a_server 使用 A2AStarletteApplication 框架实现 Google 的代理间协议，通过 AgentCard 暴露代理能力，支持代理间协作通信，默认运行在 10000 端口。mcp_server 基于 FastMCP 框架实现模型上下文协议集成，将支付功能封装为工具 API，提供核心的 proceed_payment_and_settlement_detail_info 工具，支持 SSE（服务器发送事件）传输，默认运行在 8015 端口。

dao - 数据访问层实现，集成 PostgreSQL + SQLModel 进行数据持久化。包含数据库模型定义（model.py）、数据库连接管理（database.py）和数据访问接口（app.py），支持订单、支付、结算、意图和审计事件的完整业务数据管理。

task_manager - 任务管理层实现，采用工厂模式设计。payment_service.py 提供支付服务的统一接口，task_scoped_manager.py 实现任务作用域管理，确保不同支付任务的隔离和生命周期管理。

services - 完整的区块链服务实现。签名服务同时支持 EVM 链（execute_sign.py）和 Solana 链（execute_sign_solana.py），EVM 提供 EIP-712 类型化数据签名，并支持 USDC 和 DAI 的许可签名；转账处理器采用基类抽象设计（base_handler.py），分为 custodial/ 模式（后端管理钱包以简化用户体验）和 non_custodial/ 模式（用户控制私钥以增强安全性），同时支持 EVM（evm_transfer_handler.py）和 Solana（solana_transfer_handler.py）区块链；数据服务层包括意图记录（intent.py）、审计事件（audit_event.py）、结算批次（settlement_batch.py）和结算详情（settlement_detail.py），实现完整的交易生命周期追踪；常量配置（constants.py）集中管理区块链网络配置、合约地址和链 ID；许可执行（execute_permit.py）处理 ERC-20 代币授权和许可执行。

配套控制台演示应用

配套控制台演示应用位于单独的 Zen7-Console-Demo 仓库中，为用户提供完整的交互界面和支付流程演示，让开发者能够直观体验整个支付系统的工作流程。它包含电商场景下 A2A 和 MCP 客户端的完整支付流程。

  • 购物代理客户端 演示了如何在电商场景中使用支付代理服务，实现商品浏览、下单和支付等功能。

技术栈与兼容性

支持的区块链网络：

  • EVM 兼容链：Ethereum Sepolia、Base Sepolia、Polygon Amoy、BNB Chain Testnet
  • Solana：Devnet、Testnet

兼容的代币标准：

  • EVM：USDC（版本 2）、DAI（版本 1）
  • Solana：SPL Token

签名标准：

  • EVM：EIP-712 类型化数据签名
  • Solana：Ed25519 签名

钱包集成：MetaMask、Coinbase Wallet、Phantom Wallet

数据持久化：PostgreSQL + SQLModel ORM

这种设计为开发者提供了灵活的测试环境，支持多链、多币种的完整支付解决方案，同时确保与主流钱包和区块链网络的良好兼容性。

快速开始

环境搭建

开发指南

安全注意事项

  • 私钥安全：测试环境中的私钥仅供开发使用；生产环境中请使用安全的密钥管理方案
  • 网络环境：当前支持测试网；生产环境需要相应的主网配置
  • 代币管理：确保测试钱包有足够的测试代币用于交易
  • API 安全：在生产环境中配置适当的认证和授权机制

支持

如果您遇到问题或需要帮助，请：

  • 查看文档目录中的相关指南
  • 在 GitHub Issues 上提交问题
  • 联系开发团队

关于 Zen7 Labs

Zen7 Labs 致力于构建下一代去中心化支付基础设施，专注于为代理商务提供创新的支付解决方案。通过 AI 代理技术简化区块链支付体验，我们正在开创代理经济时代支付的新范式，使代理之间的商业交互更加高效、安全和智能。

引用

如果您发现 Zen7 支付代理对您的研究或项目有帮助，请按以下方式引用：

@misc{zen7paymentagent,
  author = {Zen7 Labs},
  title = {Zen7 Payment Agent: A Dedicated Payment Network for Every Intelligent Agent.},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/Zen7-Labs/Zen7-Payment-Agent}
}

许可证

Apache License Version 2.0