Paddle MCP Server

🚀 使用 MCP 服务器处理 Paddle 账单

Paddle 账单是面向开发者的持牌商家（merchant of record），通过一个统一的 API 处理付款、税款、订阅和指标等事务，为开发者提供了一站式解决方案。

本项目是一款基于 Model Context Protocol (MCP) 的服务器，提供了与 Paddle API 交互的工具。

⚠️ 重要提示

此 MCP 服务器适用于 Paddle 账单，不支持 Paddle 经典版。如需与 Paddle 经典版配合使用，请参阅：Paddle 经典版 API 文档

✨ 主要特性

• 列出 Paddle 目录中的产品
• 创建新商品
• 查看产品的价格列表
• 为产品创建新价格
• 查看客户信息
• 查看交易记录
• 查看订阅情况
• 创建自定义报告进行财务分析

📦 安装指南

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

• 砂箱环境：https://sandbox-vendors.paddle.com/authentication-v2
• 生产环境：https://vendors.paddle.com/authentication-v2

使用 npx 运行

可以通过以下命令使用 npx 运行 Paddle MCP 服务器：

npx -y @paddle/paddle-mcp --api-key=PADDLE_API_KEY --environment=(sandbox|production)

请将 PADDLE_API_KEY 替换为您自己的 API 密钥，并传递正确的环境值（sandbox 或 production）。

在客户端中运行

要在 Claude Desktop、Cursor 或 Windsurf 等客户端中运行服务器，请在 MCP 配置中添加以下内容：

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": ["-y", "@paddle/paddle-mcp", "--api-key=PADDLE_API_KEY", "--environment=(sandbox|production)"]
    }
  }
}

详细安装指南参考

• Claude Desktop
• Cursor
• Windsurf

🚀 快速开始

开发步骤

1. 安装依赖项：

pnpm install

2. 构建服务器：

pnpm build

3. 更新客户端以使用本地构建：

{
  "mcpServers": {
    "paddle": {
      "command": "node",
      "args": ["path/to/paddle-mcp-server/build/index.js"],
      "env": {
        "PADDLE_API_KEY": "your_api_key",
        "PADDLE_ENVIRONMENT": "sandbox"
      }
    }
  }
}

调试步骤

要调试 MCP 服务器，可以使用 MCP Inspector 工具：

1. 使用 inspector 运行服务器：

pnpm inspector

2. 在浏览器中打开提供的 URL 查看和调试 MCP 请求和响应。
3. 包括 --api-key 和 --environment 参数。

📚 详细文档

• Paddle 开发文档
• [Paddle API 文档](https://developer.paddle.com/api-reference/overview?