Zen7-Payment-Agent MCP Server

官方

Zen7 Payment Agent 是 DePA（去中心化支付代理）的首個實作專案，開創了次世代智慧支付基礎設施。

GitHub
176

文件

Zen7 Payment Agent

License Python Built with uv 中文版本

即時進度更新可於 即時進度 頁面查看 如需 x402 協議的支援，請點擊此處

Zen7 Payment Agent 是 DePA（去中心化支付代理）的首個實作項目，開創了下一代智慧支付基礎設施。它不僅完整實現了 DePA 的核心功能，更在代理商務領域成功部署了創新的應用案例。

作為 DePA 生態系統中的第一個實作項目，Zen7 實現了多項關鍵功能：代理之間的自動化加密支付、「無需許可的授權」機制，以及由 LLM 驅動的意圖識別與互動。

Zen7 Payment Agent 採用多代理協作架構，同時支援 A2A 和 MCP 協議，以及託管和非託管支付模式。它為 AI 代理和原生 Dapp 應用提供了全面的支付解決方案，具備多鏈、多幣種、多錢包支援、高頻交易、免 Gas 操作和無密碼認證等特性。

Zen7 Payment Agent Architecture

儲存庫導覽

本儲存庫包含 Zen7 Payment Agent 的完整實作，展示了基於 Zen7 Payment Agent（去中心化支付代理）協議的核心組件與架構設計。

核心目錄結構

專案的核心實作位於以下關鍵目錄：

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 的 Agent-to-Agent 協議，透過 AgentCard 公開代理能力，支援代理間的協作通訊，預設在 10000 連接埠運行。mcp_server 基於 FastMCP 框架實作 Model Context Protocol 整合，將支付功能封裝為工具 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 的 permit 簽章；轉帳處理器採用基礎類別抽象設計 (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；permit 執行 (execute_permit.py) 處理 ERC-20 代幣授權和 permit 執行。

配套控制台展示應用程式

配套的控制台展示應用程式位於獨立的 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 Payment Agent 對您的研究或專案有幫助，請按以下方式引用：

@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