Zen7-Payment-Agent MCP Server

공식

Zen7 Payment Agent는 DePA(Decentralized Payment Agent)의 첫 번째 구현 프로젝트로, 차세대 지능형 결제 인프라를 개척합니다.

문서

Zen7 Payment Agent

실시간 진행 상황 업데이트는 실시간 진행 상황 페이지에서 확인할 수 있습니다. x402 프로토콜 지원에 관한 내용은 여기를 클릭하세요.

Zen7 Payment Agent는 DePA(탈중앙화 결제 에이전트)의 최초 실용적 구현체로서, 차세대 지능형 결제 인프라를 개척합니다. DePA의 핵심 기능을 완전히 구현했을 뿐만 아니라, 에이전트 상거래 영역에서 혁신적인 애플리케이션 사례를 성공적으로 배포했습니다.

DePA 생태계의 첫 번째 실용 프로젝트로서, Zen7은 에이전트 간 자동화된 암호화 결제, "무허가 승인" 메커니즘, LLM 기반 의도 인식 및 상호작용 등 여러 핵심 기능을 구현합니다.

Zen7 Payment Agent는 다중 에이전트 협업 아키텍처를 채택하여 A2A 및 MCP 프로토콜과 수탁형 및 비수탁형 결제 모델을 모두 지원합니다. 멀티체인, 다중 통화, 다중 지갑 지원, 고빈도 거래, 가스 없는 운영, 비밀번호 없는 인증을 통해 AI 에이전트 및 네이티브 Dapp 애플리케이션을 위한 포괄적인 결제 솔루션을 제공합니다.

저장소 탐색

이 저장소는 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 프레임워크를 기반으로 모델 컨텍스트 프로토콜 통합을 구현하여 결제 기능을 도구 API로 캡슐화하고, 핵심 proceed_payment_and_settlement_detail_info 도구를 제공하며, SSE(Server-Sent Events) 전송을 지원하고 기본적으로 포트 8015에서 실행됩니다.

dao - 데이터 액세스 계층 구현으로, PostgreSQL + SQLModel을 통합하여 데이터 영속성을 제공합니다. 데이터베이스 모델 정의(model.py), 데이터베이스 연결 관리(database.py) 및 데이터 액세스 인터페이스(app.py)를 포함하여 주문, 결제, 정산, 의도 및 감사 이벤트에 대한 완전한 비즈니스 데이터 관리를 지원합니다.

task_manager - 팩토리 패턴 설계를 사용한 작업 관리 계층 구현입니다. payment_service.py는 결제 서비스를 위한 통합 인터페이스를 제공하고, task_scoped_manager.py는 작업 범위 관리를 구현하여 다양한 결제 작업에 대한 격리 및 수명 주기 관리를 보장합니다.

services - 완전한 블록체인 서비스 구현입니다. 서명 서비스는 EVM 체인(execute_sign.py)과 솔라나 체인(execute_sign_solana.py)을 모두 지원하며, EVM은 EIP-712 유형 데이터 서명을 제공하고 USDC 및 DAI에 대한 허가 서명을 지원합니다. 전송 핸들러는 기본 클래스 추상화 설계(base_handler.py)를 채택하여 custodial/ 모드(백엔드가 지갑을 관리하여 사용자 경험을 단순화)와 non_custodial/ 모드(사용자가 개인 키를 제어하여 보안 강화)로 나뉘며, EVM(evm_transfer_handler.py) 및 솔라나(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 호환 체인: 이더리움 세폴리아, 베이스 세폴리아, 폴리곤 아모이, BNB 체인 테스트넷
솔라나: 개발넷, 테스트넷

호환되는 토큰 표준:

EVM: USDC (버전 2), DAI (버전 1)
솔라나: SPL 토큰

서명 표준:

EVM: EIP-712 유형 데이터 서명
솔라나: Ed25519 서명

지갑 통합: 메타마스크, 코인베이스 지갑, 팬텀 지갑

데이터 영속성: PostgreSQL + SQLModel ORM

이 설계는 개발자에게 유연한 테스트 환경을 제공하여 멀티체인 및 다중 통화 기능을 갖춘 완전한 결제 솔루션을 지원하는 동시에 주류 지갑 및 블록체인 네트워크와의 우수한 호환성을 보장합니다.

빠른 시작

빠른 시작 가이드 - 자세한 프로젝트 설정 및 실행 가이드

환경 설정

기본 환경 설치 - Python 3.13+, uv 도구 및 Git 설치
블록체인 환경 구성 - 블록체인 환경 설정 및 테스트 지갑 준비

개발 가이드

개발 가이드 - 개발자 확장 및 사용자 정의 가이드

보안 고려 사항

개인 키 보안: 테스트 환경의 개인 키는 개발 전용입니다. 프로덕션 환경에서는 안전한 키 관리 솔루션을 사용하십시오.
네트워크 환경: 현재 테스트넷을 지원합니다. 프로덕션 환경에는 해당 메인넷 구성이 필요합니다.
토큰 관리: 테스트 지갑에 거래를 위한 충분한 테스트 토큰이 있는지 확인하십시오.
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