Lemonsqueezy MCP Server

柠檬Squeezy MCP服务器

Demo GIF showing the MCP server in action

📖 关于

让您的AI助手直接访问您的支付和订阅数据。

此服务器充当您的AI助手（如VS Code、Claude Desktop或任何兼容MCP的客户端）和您的Lemon Squeezy帐户之间的桥梁。您可以简单地问AI问题，而不是手动登录仪表板、搜索订单和复制粘贴详细信息，例如：

• *“上次销售是什么？”*
• *“订阅#12345是否仍处于活动状态？”*
• *“查找所有名为‘Alice’的客户”*

你的人工智能将安全地查询数据，并在你的代码编辑器中立即给你答案。

______________________________________________________________________

🌱 初级：入门

这是给谁的？ 您是CLI工具的新手，或者只是想以最小的麻烦快速运行它。

1.先决条件

在开始之前，请确保您的计算机上安装了以下两件事：

• Node.js（版本18或更高）： 这是运行服务器的软件。 .
• 柠檬汁账户： 您需要一个帐户来获取数据。 在这里注册.

2.获取API密钥

将此视为服务器的密码。

1. 登录到您的 柠檬广场仪表板.
2. 首选 设置 -> API.
3. 点击 创建API密钥.
4. 复制密钥（以开头 ls_...). 保持安全！

3.快速安装

打开终端（Windows上的命令提示符，Mac上的终端），逐一运行以下命令：

# 1. Download the project
git clone https://github.com/IntrepidServicesLLC/lemonsqueezy-mcp-server.git
cd lemonsqueezy-mcp-server

# 2. Install the necessary files
npm install

# 3. Build the server
npm run build

4.连接到您的AI编辑器

具体步骤取决于您使用的AI编辑器。以下是最常见的：

一个复制粘贴设置（克劳德桌面/光标/npx）：\ 将其添加到MCP配置文件中（例如。 claude_desktop_config.json 或光标MCP设置）。替换 YOUR_KEY_HERE 使用Lemon Squeezy API键。

"mcpServers": {
  "lemonsqueezy": {
    "command": "npx",
    "args": ["-y", "lemonsqueezy-mcp-server"],
    "env": {
      "LEMONSQUEEZY_API_KEY": "YOUR_KEY_HERE"
    }
  }
}

*（要求包裹 。对于本地开发，请使用下面的基于路径的配置。)*

对于VS代码（本地路径）：

1. 打开VS代码设置
2. 转到扩展→ MCP
3. 添加一个新的MCP服务器：

- 命令： node - Args： ["/absolute/path/to/lemonsqueezy-mcp-server/dist/index.js"] - 环境： {"LEMONSQUEEZY_API_KEY": "your_api_key_here"}

对于Claude Desktop（本地路径）：

1. 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （Mac）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）
2. 添加与上述相同的配置（命令 node，带有完整路径的args dist/index.js)
3. 重新启动克劳德桌面

对于其他MCP客户： 有关添加MCP服务器的信息，请参阅客户的文档。服务器通过运行 node /path/to/dist/index.js 随着 LEMONSQUEEZY_API_KEY 环境变量集。

配置后，重新启动AI编辑器并尝试询问： *“给我看看我最近的5个订单。”*

______________________________________________________________________

🚀 中等用户级别：基本使用和配置

这是给谁的？ 您熟悉配置文件、环境变量，并希望自定义服务器的工作方式。

哲学：“合理违约”

此服务器旨在开箱即用，只需 一 所需设置：您的 LEMONSQUEEZY_API_KEY。其他一切都是可选的，并且具有预配置的默认值，适用于90%的用户。

配置选项

您可以使用MCP设置中的环境变量或 .env 文件。

常见任务

1.使用测试模式 如果你想在不接触真钱的情况下开发，在Lemon Squeezy中生成一个“测试API密钥”并使用 LEMONSQUEEZY_TEST_API_KEY。如果两者都存在，服务器将自动对实时密钥进行优先级排序，因此删除实时密钥以强制测试模式。

2.实现Salesforce集成（奖金） 想要将客户同步到您的CRM？ 添加这些变量：

• SALESFORCE_USERNAME
• SALESFORCE_PASSWORD
• SALESFORCE_TOKEN （安全令牌）

Salesforce的工具（如 sync_customer_to_crm)将自动出现在您的AI工具包中。

故障排除

• “找不到命令”： 确保你跑了 npm run build 安装后。
• “身份验证错误”： 双击API键。你复制了额外的空间吗？
• 日志： 服务器将日志输出到编辑器中的“MCP日志”窗口。检查那里的特定错误消息。

______________________________________________________________________

🛠️ 高级用户级别：技术文档

这是给谁的？ 开发人员、架构师和DevOps工程师正在寻找深入的技术细节、架构图、安全合规性和部署策略。

容器： 此回购同时具有 集装箱文件 和一个 Dockerfile 具有相同的构造。存在Dockerfile，因此注册表（例如Smithery）和CI会查找文件名 Dockerfile 可以发现并构建图像。您可以使用Podman或Docker进行构建；看见 集装箱.md 为什么两者都存在以及如何构建。

有关系统架构、代码模块、安全协议和企业部署指南的全面分解，请参阅：

👉 技术方案设计文件（TSD）

TSD包括：

• 系统架构和图表
• 模块互通和数据路径
• 安全与合规（AWS Secrets Manager等）
• 部署（Docker/OCI容器）
• 风险缓解策略