金大哥 - Zen7-Payment-Agent MCP 详情

article

README

🚀 Zen7支付代理

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

徽章与链接

中文版本

项目架构图

🚀 快速开始

快速开始指南 - 详细的项目设置和运行指南

环境设置

基础环境安装 - 安装Python 3.13+、uv工具和Git
区块链环境配置 - 区块链环境设置和测试钱包准备

开发指南

开发指南 - 开发者扩展和定制指南

✨ 主要特性

作为DePA生态系统中的首个实际项目，Zen7实现了以下几个关键特性：

代理之间的自动加密支付
“无许可授权”机制
由大语言模型（LLM）驱动的意图识别和交互

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

📦 安装指南

请参考快速开始部分进行环境设置和项目运行。

📚 详细文档

仓库导航

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

核心目录结构

host_agent - 多代理协作架构的核心实现。主代理使用gemini-2.0-flash-lite模型作为核心协调器，负责查询理解、状态管理和响应协调。子代理系统（sub_agents/）包含三个专门的代理：
- payer_agent：处理付款人的订单创建、EIP - 712签名生成和钱包余额验证。
- settlement_agent：专注于结算流程，确认付款细节、执行链上交易并监控交易状态。
- payee_agent：处理收款人相关操作，接收结算通知、确认订单创建并通知付款完成。
a2a_server & mcp_server - 协议适配层实现，提供多种集成方法。
- a2a_server：使用A2AStarletteApplication框架实现Google的代理到代理协议，通过AgentCard暴露代理能力，支持代理间协作通信，默认运行在端口10000。
- mcp_server：基于FastMCP框架实现模型上下文协议集成，将支付功能封装为工具API，提供核心proceed_payment_and_settlement_detail_info工具，支持服务器发送事件（SSE）传输，默认运行在端口8015。
services - 完整的区块链服务实现。
- 签名服务（execute_sign.py）：提供EIP - 712类型数据签名功能，支持USDC和DAI的许可签名。
- 转账处理程序分为custodial/模式（后端管理钱包以简化用户体验）和non_custodial/模式（用户控制私钥以增强安全性）。
- 常量配置（constants.py）：集中管理区块链网络配置、合约地址和链ID。
- 许可执行（execute_permit.py）：处理ERC - 20代币授权和许可执行。

配套控制台演示应用

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

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

技术栈与兼容性

| 属性 | 详情 | |------|------| | 支持的区块链网络 | 以太坊Sepolia、Base Sepolia测试网 | | 兼容的代币标准 | USDC（版本2）、DAI（版本1） | | 签名标准 | EIP - 712类型数据签名 | | 钱包集成 | MetaMask、Coinbase钱包 |

这种设计为开发者提供了灵活的测试环境，同时确保与主流钱包和区块链网络具有良好的兼容性。

🔧 技术细节

安全考虑

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

📄 许可证

本项目采用Apache License Version 2.0许可协议。

关于Zen7 Labs

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

引用

如果您在研究或项目中发现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}
}

支持

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

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

Zen7-Payment-Agent