PayPal MCP 서버

PayPal API와의 포괄적인 통합을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 표준화된 인터페이스를 통해 PayPal의 결제 처리, 송장 발행, 구독 관리 및 비즈니스 운영과 원활하게 연동됩니다.

특징

결제 처리

주문 관리 : 주문 생성, 업데이트 및 추적
결제 처리 : 다양한 방법으로 결제 처리
결제 토큰 : 향후 사용을 위해 결제 토큰을 생성하고 관리합니다.
분쟁 관리 : 지불 분쟁 및 해결을 처리합니다.

사업 운영

제품 관리 : 제품 카탈로그를 만들고 관리합니다.
송장 발행 : 전문적인 송장을 생성하고 발송합니다.
지급 : 여러 수신자에게 일괄 지급 처리
구독 관리 : 정기 청구 생성 및 관리

사용자 관리

신원 확인 : 사용자 신원을 확인합니다.
사용자 정보 : 사용자 데이터 검색 및 관리
웹 프로필 관리 : 결제 경험 맞춤화

건축학

지엑스피1

설치

필수 조건

Node.js 16.x 이상
API 자격 증명이 있는 PayPal 개발자 계정

수동 설치

저장소를 복제합니다
git clone https://github.com/arbuthnot-eth/PayPal-MCP.git cd PayPal-MCP
종속성 설치
npm install
프로젝트를 빌드하세요
npm run build
MCP 설정 파일에서 PayPal 자격 증명을 구성하세요.
{ "mcpServers": { "paypal": { "command": "node", "args": ["path/to/paypal-mcp/build/index.js"], "env": { "PAYPAL_CLIENT_ID": "your_client_id", "PAYPAL_CLIENT_SECRET": "your_client_secret", "PAYPAL_ENVIRONMENT": "sandbox" // or "live" }, "disabled": false, "autoApprove": [] } } }

사용 가능한 도구

결제 운영

결제 토큰 생성

나중에 사용할 결제 토큰을 만듭니다.

{
  customer: {
    id: string;
    email_address?: string;
  };
  payment_source: {
    card?: {
      name: string;
      number: string;
      expiry: string;
      security_code: string;
    };
    paypal?: {
      email_address: string;
    };
  };
}

생성_주문

PayPal에서 새로운 주문을 만듭니다.

{
  intent: 'CAPTURE' | 'AUTHORIZE';
  purchase_units: Array<{
    amount: {
      currency_code: string;
      value: string;
    };
    description?: string;
    reference_id?: string;
    items?: Array<{
      name: string;
      quantity: string;
      unit_amount: {
        currency_code: string;
        value: string;
      };
    }>;
  }>;
  application_context?: {
    brand_name?: string;
    shipping_preference?: 'GET_FROM_FILE' | 'NO_SHIPPING' | 'SET_PROVIDED_ADDRESS';
    user_action?: 'CONTINUE' | 'PAY_NOW';
  };
}

캡처 순서

승인된 주문에 대한 결제를 접수합니다.

{
  order_id: string;
  payment_source?: {
    token?: {
      id: string;
      type: string;
    };
  };
}

구독 생성

정기 결제를 위한 구독을 만드세요.

{
  plan_id: string;
  subscriber: {
    name: {
      given_name: string;
      surname: string;
    };
    email_address: string;
  };
  application_context?: {
    brand_name?: string;
    shipping_preference?: 'GET_FROM_FILE' | 'NO_SHIPPING' | 'SET_PROVIDED_ADDRESS';
    user_action?: 'CONTINUE' | 'SUBSCRIBE_NOW';
    payment_method?: {
      payer_selected?: string;
      payee_preferred?: string;
    };
  };
}

사업 운영

제품 생성

카탈로그에 새로운 제품을 만듭니다.

{
  name: string;
  description: string;
  type: 'PHYSICAL' | 'DIGITAL' | 'SERVICE';
  category: string;
  image_url?: string;
  home_url?: string;
}

송장 생성

새로운 송장을 생성합니다.

{
  invoice_number: string;
  reference: string;
  currency_code: string;
  recipient_email: string;
  items: Array<{
    name: string;
    quantity: string;
    unit_amount: {
      currency_code: string;
      value: string;
    };
    description?: string;
    tax?: {
      name: string;
      percent: string;
    };
  }>;
  note?: string;
  terms_and_conditions?: string;
  memo?: string;
  payment_term?: {
    term_type: 'DUE_ON_RECEIPT' | 'DUE_ON_DATE' | 'NET_10' | 'NET_15' | 'NET_30' | 'NET_45' | 'NET_60' | 'NET_90';
    due_date?: string;
  };
}

지불 생성

일괄 지급을 처리합니다.

{
  sender_batch_header: {
    sender_batch_id: string;
    email_subject?: string;
    recipient_type?: string;
  };
  items: Array<{
    recipient_type: string;
    amount: {
      value: string;
      currency: string;
    };
    receiver: string;
    note?: string;
  }>;
}

오류 처리

서버는 포괄적인 오류 처리를 구현합니다.

입력 검증 : 특정 메시지에 대한 자세한 검증 오류
PayPal API 오류 : PayPal 오류 세부 정보가 포함된 구조화된 오류 응답
네트워크 오류 : 일시적인 네트워크 문제에 대한 재시도 논리
인증 오류 : 토큰 자동 새로 고침 및 오류 메시지 지우기
속도 제한 : API 속도 제한을 위한 백오프 전략

보안 고려 사항

모든 민감한 데이터는 검증 및 정리됩니다.
PayPal을 사용한 OAuth 2.0 인증
환경 변수를 통한 보안 자격 증명 관리
모든 API 매개변수에 대한 입력 검증
오류 메시지는 민감한 정보를 노출하지 않습니다.

개발

건물

npm run build

개발 모드에서 실행

npm run dev

테스트

npm test

린팅

npm run lint

서식

npm run format

기여하다

저장소를 포크하세요
기능 브랜치 생성
변경 사항을 커밋하세요
지점으로 밀어 넣기
풀 리퀘스트 만들기

특허

MIT 라이센스

PayPal MCP Server

Integrations

PayPal MCP 서버

특징

결제 처리

사업 운영

사용자 관리

건축학

설치

필수 조건

수동 설치

사용 가능한 도구

결제 운영

결제 토큰 생성

생성_주문

캡처 순서

구독 생성

사업 운영

제품 생성

송장 생성

지불 생성

오류 처리

보안 고려 사항

개발

건물

개발 모드에서 실행

테스트

린팅

서식

기여하다

특허