桨-MCP服务器

Name: 桨-MCP服务器
Author: PaddleHQ

作者：PaddleHQ33 星标更新：2025-11-19

安装使用来源：spider==github.com

项目介绍

MCP Server for Paddle Billing

Paddle Billing 是面向开发者的记录商。我们通过一个统一的API来处理支付、税务、订阅和指标。

这是一个 Model Context Protocol (MCP) 服务器，它为LLMs和AI代理提供了与Paddle API交互的工具。

重要提示： 此MCP服务器适用于Paddle Billing。它不支持Paddle Classic。如需使用Paddle Classic，请参阅：Paddle Classic API参考

功能

该MCP服务器几乎与Paddle API完全一致，允许AI助手和代理进行以下操作：

管理您的整个Paddle目录
查看客户、购买和配置信息
处理订阅、支付和退款工作流
调试计费和订单管理问题
在对话中直接创建和调整交易
生成财务报告以获得财务和运营洞察
更快地实现和测试Paddle集成

可用工具

该MCP服务器可以使用以下工具对您的Paddle账户执行操作：

操作	工具	非破坏性	只读
列出产品	`list_products`	✅	✅
创建产品	`create_product`	✅	❌
获取产品	`get_product`	✅	✅
更新产品	`update_product`	❌	❌

</details> <details> <summary>价格</summary>

操作	工具	非破坏性	只读
列出价格	`list_prices`	✅	✅
创建价格	`create_price`	✅	❌
获取价格	`get_price`	✅	✅
更新价格	`update_price`	❌	❌
预览价格	`preview_prices`	✅	❌

</details> <details> <summary>折扣</summary>

操作	工具	非破坏性	只读
列出折扣	`list_discounts`	✅	✅
创建折扣	`create_discount`	✅	❌
获取折扣	`get_discount`	✅	✅
更新折扣	`update_discount`	❌	❌

</details> <details> <summary>折扣组</summary>

操作	工具	非破坏性	只读
列出折扣组	`list_discount_groups`	✅	✅
创建折扣组	`create_discount_group`	✅	❌
获取折扣组	`get_discount_group`	✅	✅
更新折扣组	`update_discount_group`	❌	❌
归档折扣组	`archive_discount_group`	❌	❌

</details> <details> <summary>客户</summary>

操作	工具	非破坏性	只读
列出客户	`list_customers`	✅	✅
创建客户	`create_customer`	✅	❌
获取客户	`get_customer`	✅	✅
更新客户	`update_customer`	❌	❌
列出客户的信用余额	`list_credit_balances`	✅	✅

</details> <details> <summary>地址</summary>

操作	工具	非破坏性	只读
列出客户的地址	`list_addresses`	✅	✅
创建客户的地址	`create_address`	✅	❌
获取客户的地址	`get_address`	✅	✅
更新客户的地址	`update_address`	❌	❌

</details> <details> <summary>企业</summary>

操作	工具	非破坏性	只读
列出客户的企业的	`list_businesses`	✅	✅
创建客户的企业的	`create_business`	✅	❌
获取客户的企业的	`get_business`	✅	✅
更新客户的企业的	`update_business`	❌	❌

</details> <details> <summary>交易</summary>

操作	工具	非破坏性	只读
列出交易	`list_transactions`	✅	✅
创建交易	`create_transaction`	✅	❌
获取交易	`get_transaction`	✅	✅
更新交易	`update_transaction`	❌	❌
预览交易	`preview_transaction_create`	✅	❌
修改已计费或已完成交易的客户信息	`revise_transaction`	❌	❌
获取交易的PDF发票	`get_transaction_invoice`	✅	✅

</details> <details> <summary>调整</summary>

操作	工具	非破坏性	只读
列出调整	`list_adjustments`	✅	✅
创建调整	`create_adjustment`	✅	❌
获取调整的PDF贷项单	`get_adjustment_credit_note`	✅	✅

</details> <details> <summary>订阅</summary>

操作	工具	非破坏性	只读
列出订阅	`list_subscriptions`	✅	✅
获取订阅	`get_subscription`	✅	✅
更新订阅	`update_subscription`	❌	❌
取消订阅	`cancel_subscription`	❌	❌
暂停订阅	`pause_subscription`	❌	❌
恢复暂停的订阅	`resume_subscription`	❌	❌
激活试用订阅	`activate_subscription`	❌	❌
预览订阅更新	`preview_subscription_update`	✅	❌
为订阅创建一次性费用	`create_subscription_charge`	✅	❌
预览订阅的一次性费用	`preview_subscription_charge`	✅	❌

</details> <details> <summary>保存的付款方式</summary>

操作	工具	非破坏性	只读
列出为客户保存的付款方式	`list_saved_payment_methods`	✅	✅
获取为客户保存的付款方式	`get_saved_payment_method`	✅	✅
删除为客户保存的付款方式	`delete_saved_payment_method`	❌	❌

</details> <details> <summary>客户门户会话</summary>

操作	工具	非破坏性	只读
创建客户门户会话	`create_customer_portal_session`	✅	❌

</details> <details> <summary>通知设置</summary>

操作	工具	非破坏性	只读
列出通知设置	`list_notification_settings`	✅	✅
创建通知设置	`create_notification_setting`	✅	❌
获取通知设置	`get_notification_setting`	✅	✅
更新通知设置	`update_notification_setting`	❌	❌
删除通知设置	`delete_notification_setting`	❌	❌

</details> <details> <summary>事件</summary>

操作	工具	非破坏性	只读
列出事件	`list_events`	✅	✅

</details> <details> <summary>通知</summary>

操作	工具	非破坏性	只读
列出通知	`list_notifications`	✅	✅
获取通知	`get_notification`	✅	✅
重播通知	`replay_notification`	✅	❌

</details> <details> <summary>通知日志</summary>

操作	工具	非破坏性	只读
列出通知的日志	`list_notification_logs`	✅	✅

</details> <details> <summary>模拟</summary>

操作	工具	非破坏性	只读
列出模拟	`list_simulations`	✅	✅
创建模拟	`create_simulation`	✅	❌
获取模拟	`get_simulation`	✅	✅
更新模拟	`update_simulation`	❌	❌

</details> <details> <summary>模拟运行</summary>

操作	工具	非破坏性	只读
列出模拟的运行	`list_simulation_runs`	✅	✅
创建模拟的运行	`create_simulation_run`	✅	❌
获取模拟的运行	`get_simulation_run`	✅	✅

</details> <details> <summary>模拟运行事件</summary>

操作	工具	非破坏性	只读
列出模拟运行的事件	`list_simulation_run_events`	✅	✅
获取模拟运行的事件	`get_simulation_run_event`	✅	✅
重播模拟运行的事件	`replay_simulation_run_event`	✅	❌

</details> <details> <summary>报告</summary>

操作	工具	非破坏性	只读
列出报告	`list_reports`	✅	✅
创建报告	`create_report`	✅	❌
获取报告	`get_report`	✅	✅
获取报告的CSV文件	`get_report_csv`	✅	✅

</details> <details> <summary>客户端令牌</summary>

操作	工具	非破坏性	只读
列出客户端令牌	`list_client_side_tokens`	✅	✅
创建客户端令牌	`create_client_side_token`	✅	❌
获取客户端令牌	`get_client_side_token`	✅	✅
撤销客户端令牌	`revoke_client_side_token`	❌	❌

</details>

安装

要使用MCP服务器，您需要一个API密钥。您可以在Paddle > 开发者工具 > 认证中创建和管理API密钥：

沙盒环境: https://sandbox-vendors.paddle.com/authentication-v2
生产环境: https://vendors.paddle.com/authentication-v2

在像Claude Desktop、Cursor或Windsurf这样的客户端中添加以下内容到您的MCP设置文件中，即可配置并运行Paddle MCP服务器：

方法1：在Cursor或VS Code中一键安装

您可以通过单击在Cursor或VS Code中安装Paddle MCP服务器。

安装后，您需要更新MCP设置文件中的配置，将your_api_key替换为您实际的Paddle API密钥，并根据需要调整环境和工具值。

方法2：使用命令行参数（推荐用于`npx`）

在您使用的客户端的MCP设置或配置文件中添加以下内容：

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

将your_api_key替换为您实际的Paddle API密钥，将--environment设置为sandbox或production，并将--tools设置为您希望加载并可供MCP客户端使用的工具。

方法3：使用环境变量

在您使用的客户端的MCP设置或配置文件中添加以下内容：

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": ["-y", "@paddle/paddle-mcp"],
      "env": {
        "PADDLE_API_KEY": "your_api_key",
        "PADDLE_ENVIRONMENT": "sandbox",
        "PADDLE_MCP_TOOLS": "non-destructive"
      }
    }
  }
}

将your_api_key替换为您实际的Paddle API密钥，将PADDLE_ENVIRONMENT设置为sandbox或production，并将PADDLE_MCP_TOOLS设置为您希望加载并可供MCP客户端使用的工具。

过滤工具

您可以通过传递--tools参数（方法2）或设置PADDLE_MCP_TOOLS环境变量（方法1或3）来过滤哪些工具被加载并可供MCP客户端使用。接受的值包括：

all - 所有工具都