PayPal MCP 서버
DynamicEndpoints 에서 유지 관리 - 연락처: kameron@dynamicendpoints.com
PayPal API와의 통합을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 표준화된 인터페이스를 통해 PayPal의 결제 처리, 송장 발행 및 비즈니스 관리 기능과 원활하게 상호 작용할 수 있도록 지원합니다.
건축학
지엑스피1
특징
- 결제 처리
- 주문 생성 및 관리
- 결제 처리
- 결제 토큰 처리
- 분쟁 관리
- 사업 운영
- 제품 생성 및 관리
- 송장 생성
- 지급 처리
- 파트너 추천 처리
- 사용자 관리
설치
Smithery를 통해 설치
Smithery 를 통해 Claude Desktop에 PayPal MCP 서버를 자동으로 설치하려면:
npx -y @smithery/cli install @DynamicEndpoints/Paypal-MCP --client claude
수동 설치
- 저장소를 복제합니다
- 종속성 설치:
- 프로젝트를 빌드하세요:
- MCP 설정 파일에서 PayPal 자격 증명을 구성합니다.
{
"mcpServers": {
"paypal": {
"command": "node",
"args": ["path/to/paypal-server/build/index.js"],
"env": {
"PAYPAL_CLIENT_ID": "your_client_id",
"PAYPAL_CLIENT_SECRET": "your_client_secret"
},
"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;
}>;
}
결제 생성
직접 결제를 생성합니다.
{
intent: string;
payer: {
payment_method: string;
funding_instruments?: Array<{
credit_card?: {
number: string;
type: string;
expire_month: number;
expire_year: number;
cvv2: string;
first_name: string;
last_name: string;
};
}>;
};
transactions: Array<{
amount: {
total: string;
currency: string;
};
description?: 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;
};
}>;
}
지불 생성
일괄 지급을 처리합니다.
{
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;
}>;
}
사용자 및 프로필 관리
사용자 정보 가져오기
사용자 정보를 검색합니다.
{
access_token: string;
}
웹_프로필_생성
웹 경험 프로필을 만드세요.
{
name: string;
presentation?: {
brand_name?: string;
logo_image?: string;
locale_code?: string;
};
input_fields?: {
no_shipping?: number;
address_override?: number;
};
flow_config?: {
landing_page_type?: string;
bank_txn_pending_url?: string;
};
}
사용 예
주문 생성
const result = await mcpClient.useTool('paypal', 'create_order', {
intent: 'CAPTURE',
purchase_units: [{
amount: {
currency_code: 'USD',
value: '100.00'
},
description: 'Premium Subscription'
}]
});
송장 생성
const result = await mcpClient.useTool('paypal', 'create_invoice', {
invoice_number: 'INV-2024-001',
reference: 'REF-2024-001',
currency_code: 'USD',
recipient_email: 'customer@example.com',
items: [{
name: 'Consulting Services',
quantity: '1',
unit_amount: {
currency_code: 'USD',
value: '500.00'
}
}]
});
지급 처리
const result = await mcpClient.useTool('paypal', 'create_payout', {
sender_batch_header: {
sender_batch_id: 'Payroll_2024_001',
email_subject: 'You have received a payment'
},
items: [{
recipient_type: 'EMAIL',
amount: {
value: '1000.00',
currency: 'USD'
},
receiver: 'employee@example.com',
note: 'Monthly salary payment'
}]
});
오류 처리
서버는 포괄적인 오류 처리를 구현합니다.
- 자세한 메시지가 포함된 입력 검증 오류
- 응답 세부 정보가 포함된 PayPal API 오류
- 네트워크 및 인증 오류
- 속도 제한 및 시간 초과 처리
보안 고려 사항
- 모든 민감한 데이터는 검증 및 정리됩니다.
- PayPal을 사용한 OAuth 2.0 인증
- 환경 변수를 통한 보안 자격 증명 관리
- 모든 API 매개변수에 대한 입력 검증
- 오류 메시지는 민감한 정보를 노출하지 않습니다.
개발
건물
테스트
디버깅
서버는 디버깅에 도움이 되는 자세한 로그를 출력합니다.
- 인증 문제
- API 호출 실패
- 검증 오류
- 요청/응답 세부 정보
기여하다
- 저장소를 포크하세요
- 기능 브랜치 생성
- 변경 사항을 커밋하세요
- 지점으로 밀어 넣기
- 풀 리퀘스트 만들기
특허
MIT 라이센스