PayPal MCP 服务器
由DynamicEndpoints维护 - 联系方式: kameron@dynamicendpoints.com
一个模型上下文协议 (MCP) 服务器,提供与 PayPal API 的集成。该服务器通过标准化接口实现与 PayPal 的支付处理、发票和业务管理功能的无缝交互。
建筑学
特征
安装
通过 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 许可证