Paddlehq Paddle MCP Server

🚀 Paddle 賬單 MCP 服務器

Paddle 賬單是面向開發者的持牌商家，負責處理支付、稅務、訂閱和指標等事務，並提供一個統一的 API 來完成所有操作。本項目是一個基於模型上下文協議 (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 密鑰，並指定正確的環境值。

在客戶端中運行

要在 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

💻 使用示例

基礎用法

在客戶端中運行服務器的配置示例：

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

高級用法

在本地開發環境構建並運行服務器：

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

🔧 技術細節

開發步驟

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 檢查工具：

1. 使用檢查工具運行服務器：

pnpm inspector

2. 在瀏覽器中打開提供的 URL 查看並調試 MCP 請求和響應。
3. 包括 --api-key 和 --environment 參數。

📚 詳細文檔

• Paddle 開發文檔
• Paddle API 文檔
• 註冊 Paddle 賬單