← 返回目录

Paddle MCP Server

官方

通过AI助手与Paddle Billing API交互，管理产品目录、计费和订阅。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 10 / 230
Stars: ★ 49 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 5 个月前
工具数: 83

70FMRS · B

Paddle MCP服务器提供与Paddle Billing API的广泛集成，支持众多工具，功能强大。但需要注意权限控制和环境设置，避免误操作。

最强项 · 维护活跃度 17/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

15/20

维护活跃度

17/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: 源码包含完整的 build 脚本（package.json）、TypeScript 源码和测试文件（test/ 目录），且有 GitHub Actions CI（.github/workflows）存在，表明初始化流程设计合理。但本审查未实际运行代码，且 CI 配置和测试覆盖的具体内容未提供，因此无法验证关键路径确实可复现或失败信息得到控制。扣分原因：静态审查无法确证工具的精确行为，错误处理和边界情况仅从源码难以完全评估。
安全与权限 15/20: 示例配置使用你提供的占位符（如 your_api_key），未发现硬编码密钥。支持环境变量和命令行参数传递密钥，但密钥可能通过进程列表暴露。提供 --tools 过滤选项，默认 non-destructive，允许 read-only 和特定工具选择，符合最小权限原则。未发现恶意远程调用或数据外泄迹象。扣分原因：密钥传递方式（API key 作为命令行参数）在进程可见性上存在风险；文档未说明密钥存储的最佳实践，且对破坏性操作（如取消订阅）的确认机制默认未强制。
维护活跃度 17/20: 许可证为 Apache-2.0，仓库显示活跃（50 stars, 5 个 open issues），未归档。存在 GitHub Actions CI 和构建脚本，表明有版本化发布流程。但未提供最近的提交历史或发布记录，无法确认维护的持续性。扣分原因：未提供维护者响应时间或安全响应渠道的详细信息。
文档质量 16/20: README 提供了安装、配置、环境变量和命令行参数说明，包含工具列表并区分只读与非破坏性操作，且有 Cursor 和 VS Code 一键安装示例。但缺少详细的工具参数说明、错误处理指南和常见问题解答，且未提及速率限制或成本。扣分原因：文档未覆盖工具参数的具体类型和必需项，也缺少故障排除部分。
安装易用性 13/20: 提供多种安装方法，包括 npx 命令和本地构建，以及 Cursor/VS Code 一键安装。配置示例清晰，但要求用户手动获取 API 并设置环境变量。静态审查未执行，且 CI 存在但未验证构建在主流客户端的兼容性。扣分原因：静态审查无法确证安装过程的顺利，且未提供对 Windows 等平台的具体说明。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

使用Paddle Billing的开发者
将AI助手集成到支付和订阅工作流
通过自然语言查询Paddle API数据

不适合谁

使用Paddle Classic的用户
不需要与Paddle API交互的场景

所需权限

需要Paddle API密钥
根据工具过滤，可进行读取、非破坏性写入或破坏性操作

风险与副作用

API密钥泄露可能导致数据泄露或未经授权的操作
破坏性工具（如更新、取消、暂停订阅）可能造成不可逆的变更
请确保在沙盒环境测试后再用于生产

安装接入

准备工作

运行环境：Node.js

PADDLE_API_KEY 必填密钥 Paddle API 密钥，在 Paddle 后台 Developer tools > Authentication（沙盒或线上）创建，必填且为机密。

其他可选配置项（2 个）

PADDLE_ENVIRONMENT 可选指定连接环境，取值为 sandbox 或 production，默认沙盒。

PADDLE_MCP_TOOLS 可选控制加载哪些工具：all、read-only、non-destructive（默认）或逗号分隔的工具名列表。

获取Paddle API密钥（在Paddle > Developer tools > Authentication中创建，沙盒或生产环境）。
在MCP客户端（如Claude Desktop、Cursor、VS Code、Windsurf）的配置文件中添加服务器配置。可以使用命令行参数或环境变量。
根据需要设置环境（sandbox或production）和工具过滤（all、read-only、non-destructive或特定工具列表）。

claude_desktop_config.json

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": [
        "-y",
        "@paddle/paddle-mcp",
        "--api-key=your_api_key",
        "--environment=sandbox",
        "--tools=non-destructive"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "paddle": {
      "command": "npx",
      "args": [
        "-y",
        "@paddle/paddle-mcp",
        "--api-key=your_api_key",
        "--environment=sandbox",
        "--tools=non-destructive"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add paddle -- npx -y @paddle/paddle-mcp --api-key=your_api_key --environment=sandbox --tools=non-destructive

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应出现 paddle 服务器的工具（如 list_products）；也可提示"列出我的 Paddle 产品"，若返回沙盒账户中的产品数据则说明连接成功。

常见排障

检查API密钥是否有效
确认环境变量或命令行参数正确（如--environment=sandbox）
使用MCP Inspector调试请求和响应

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我 Paddle 沙盒环境中的所有产品
创建一个名为 Pro Plan 的新产品，并添加一个每月 29 美元的价格
暂停订阅 sub_12345 并预览这次更改对客户的影响
为上个月的交易生成一份收入报告并下载 CSV

工具能力 83

list_products 只读

列出产品

create_product 写入

创建产品

get_product 只读

获取产品详情

update_product 写入

更新产品

list_prices 只读

列出价格

create_price 写入

创建价格

get_price 只读

获取价格详情

update_price 写入

更新价格

展开其余 75 个工具

preview_prices 只读

预览价格

list_discounts 只读

列出折扣

create_discount 写入

创建折扣

get_discount 只读

获取折扣详情

update_discount 写入

更新折扣

list_discount_groups 只读

列出折扣组

create_discount_group 写入

创建折扣组

get_discount_group 只读

获取折扣组详情

update_discount_group 写入

更新折扣组

archive_discount_group 破坏性

归档折扣组

list_customers 只读

列出客户

create_customer 写入

创建客户

get_customer 只读

获取客户详情

update_customer 写入

更新客户

list_credit_balances 只读

列出客户信用余额

list_addresses 只读

列出客户地址

create_address 写入

创建客户地址

get_address 只读

获取客户地址

update_address 写入

更新客户地址

list_businesses 只读

列出客户业务

create_business 写入

创建客户业务

get_business 只读

获取客户业务

update_business 写入

更新客户业务

list_transactions 只读

列出交易

create_transaction 写入

创建交易

get_transaction 只读

获取交易详情

update_transaction 写入

更新交易

preview_transaction_create 只读

预览交易创建

revise_transaction 破坏性

修订已开票或完成的交易

get_transaction_invoice 只读

获取交易PDF发票

list_adjustments 只读

列出调整

create_adjustment 写入

创建调整

get_adjustment_credit_note 只读

获取调整PDF信用通知

list_subscriptions 只读

列出订阅

get_subscription 只读

获取订阅详情

update_subscription 写入

更新订阅

cancel_subscription 破坏性

取消订阅

pause_subscription 写入

暂停订阅

resume_subscription 写入

恢复暂停的订阅

activate_subscription 写入

激活试用订阅

preview_subscription_update 只读

预览订阅更新

create_subscription_charge 写入

为订阅创建一次性收费

preview_subscription_charge 只读

预览订阅一次性收费

list_saved_payment_methods 只读

列出客户保存的支付方式

get_saved_payment_method 只读

获取客户保存的支付方式

delete_saved_payment_method 破坏性

删除客户保存的支付方式

create_customer_portal_session 写入

创建客户门户会话

list_notification_settings 只读

列出通知设置

create_notification_setting 写入

创建通知设置

get_notification_setting 只读

获取通知设置详情

update_notification_setting 写入

更新通知设置

delete_notification_setting 破坏性

删除通知设置

list_events 只读

列出事件

list_notifications 只读

列出通知

get_notification 只读

获取通知详情

replay_notification 写入

重放通知

list_notification_logs 只读

列出通知日志

list_simulations 只读

列出模拟

create_simulation 写入

创建模拟

get_simulation 只读

获取模拟详情

update_simulation 写入

更新模拟

list_simulation_runs 只读

列出模拟运行

create_simulation_run 写入

创建模拟运行

get_simulation_run 只读

获取模拟运行详情

list_simulation_run_events 只读

列出模拟运行事件

get_simulation_run_event 只读

获取模拟运行事件

replay_simulation_run_event 写入

重放模拟运行事件

list_reports 只读

列出报告

create_report 写入

创建报告

get_report 只读

获取报告详情

get_report_csv 只读

获取报告CSV文件

list_client_side_tokens 只读

列出客户端令牌

create_client_side_token 写入

创建客户端令牌

get_client_side_token 只读

获取客户端令牌详情

revoke_client_side_token 破坏性

吊销客户端令牌

使用场景

管理产品目录和定价

处理订阅、支付和退款

调试账单和订单管理

在对话中创建和调整交易

生成财务报告

支持客户端

Claude Desktop

Cursor

VS Code

Windsurf

依据项目文档列出，未经本站实测。

详细介绍

这是一个Model Context Protocol (MCP)服务器，为LLM和AI代理提供与Paddle API交互的工具。支持Paddle Billing，不支持Paddle Classic。功能几乎与Paddle API相当，允许管理产品目录、查看客户和购买信息、处理订阅和支付流程、调试账单问题、在对话中创建和调整交易、生成财务报告等。