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?