Lemon Squeezy Server

Una implementació de servidor Model Context Protocol (MCP) que s’integra amb Lemon Squeezy per gestionar subscripcions, pagaments, productes i més. Aquest servidor ofereix una interfície estructurada per gestionar el vostre botiga Lemon Squeezy de manera programàtica amb registre d’auditoria i control basat en eines.

Demo

Requisits

• Python 3.8+
• MCP SDK 0.1.0+
• aiohttp
• python-dotenv

Components

Recursos

El servidor proporciona un recurs compatible amb MCP per a l’auditoria d’operacions:

• Emmagatzema registres de totes les operacions de Lemon Squeezy basades en eines
• Exposa el registre d’auditoria a través de l’endpoint read_resource
• Útil per a la depuració i la traçabilitat d’auditoria

Eines

Implementa un conjunt complet d’operacions Lemon Squeezy a través d’eines MCP:

🔍 Store & Product Tools

• get_user: Obtén informació de l’usuari actual de Lemon Squeezy
• list_stores: Llista totes les botigues
• get_store: Obtén una botiga específica
• list_products: Llista productes
• get_product: Obtén detalls d’un producte
• get_product_variants: Llista variants d’un producte

📦 Order & Customer Tools

• list_orders: Llista totes les comandes
• get_order: Obtén detalls d’una comanda
• list_customers: Llista tots els clients
• get_customer: Obtén detalls d’un client

💳 Subscription & License Tools

• list_subscriptions: Llista subscripcions
• get_subscription: Obtén una subscripció
• list_license_keys: Llista claus de llicència
• get_license_key: Obtén informació d’una clau de llicència

🛒 Checkout & Webhook Tools

• create_checkout: Crea una sessió de pagament completament personalitzada
• create_webhook: Registra un nou webhook
• list_webhooks: Llista tots els webhooks (filtrables per botiga)

Característiques

• Gestió de subscripcions i pagaments
• Creació i llista de webhooks
• Registre d’auditoria de totes les accions
• Integració d’eines i recursos compatibles amb MCP
• Feedback i registre d’errors

Instal·lació

Instal·lació via Smithery

Per instal·lar LemonSqueezy Server per a Claude Desktop automàticament via Smithery:

npx -y @smithery/cli install @atharvagupta2003/mcp-lemonsqueezy --client claude

Instal·lar dependències

python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate    # On Windows
pip install -e .

Configuració

Configura les variables d’entorn en un fitxer .env:

LEMON_SQUEEZY_API_KEY=your_lemonsqueezy_api_key

Claude Desktop

Afegeix la configuració del servidor al teu fitxer de configuració de Claude Desktop:

Windows: C:\Users<username>\AppData\Roaming\Claude\claude_desktop_config.json

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "lemonsqueezy": {
      "command": "/Users/hp/.local/bin/uv",
      "description": "Operations with lemonsqueezy payment platform",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/mcp_lemonsqueezy",
        "run",
        "--with",
        "fastmcp",
        "server.py"
      ],
      "env": {
         "LEMONSQUEEZY_API_KEY": "<YOUR-API-KEY>"
       }
    }
  }
}

Ús

Iniciar el servidor

uv run src/mcp_lemonsqueezy/server.py

Exemples de comandes MCP

Obtenir l'usuari actual

{
  "tool": "get_user",
  "arguments": {}
}

Llistar totes les botigues

{
  "tool": "list_stores",
  "arguments": {}
}

Obtenir una botiga per ID

{
  "tool": "get_store",
  "arguments": {
    "store_id": "164870"
  }
}

Gestió d'errors

El servidor proporciona missatges d’error clars per a escenaris comuns:

• 401 Unauthorized: Clau d’API desapareguda o no vàlida
• 422 Unprocessable Entity: Camps no vàlids com a ID de variant/botiga falta
• 400 Bad Request: Estructura JSON de l’API no vàlida

Desenvolupament

Proves

Executa l’inspector MCP per a proves interactives:

npx @modelcontextprotocol/inspector uv run --with fastmcp /ABSOLUTE/PATH/TO/PARENT/FOLDER/src/mcp_lemonsqueezy/server.py

Construcció

• 1. Actualitza les dependències:

uv compile pyproject.toml

• 2. Construeix el paquet:

uv build

Contribució

Donem la benvinguda a les contribucions! Si us plau, consulteu les nostres Directrius de Contribució per a més detalls.

Llicència

Aquest projecte està llicenciat sota la Llicència MIT - vegeu el fitxer LICENSE per a més