Skip to main content
Glama
Lotería MCP

Lotería MCP

by parrotsoft

🎟️ MCP-Lotterie

MCP-Server zum Abfragen von Lotterien und Ergebnissen über die API de Resultados de Loterías.

Er stellt zwei Tools bereit, die jeder kompatible MCP-Client (Claude Desktop, Cursor usw.) direkt aus dem Chat heraus aufrufen kann.


📋 Anforderungen

Tool

Mindestversion

Python

3.10+

uv

latest


Related MCP server: Marvel MCP

⚙️ Installation

1. Repository klonen

git clone https://github.com/parrotsoft/loteria-mcp
cd loteria

2. Virtuelle Umgebung erstellen und Abhängigkeiten mit uv installieren

uv sync

Dies erstellt automatisch die .venv-Umgebung und installiert alle in pyproject.toml deklarierten Abhängigkeiten.


🚀 Verwendung mit Claude Desktop

Fügen Sie die folgende Konfiguration zur Claude Desktop-Datei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "loteria": {
      "command": "uv",
      "args": [
        "--directory",
        "/ruta/absoluta/al/proyecto/loteria",
        "run",
        "loteria.py"
      ]
    }
  }
}

Hinweis: Ersetzen Sie /ruta/absoluta/al/proyecto/loteria durch den tatsächlichen Pfad des Projekts auf Ihrem Computer.

Starten Sie Claude Desktop neu, dann ist der Server verfügbar.


🛠️ Verfügbare Tools

get_lotteries

Gibt die vollständige Liste der in der API verfügbaren Lotterien zurück.

Keine Parameter.

Beispielantwort:

{
  "data": [
    { "id": 1, "name": "Lotería Nacional", "country": "MX" },
    { "id": 2, "name": "Melate", "country": "MX" }
  ]
}

get_resultados

Gibt die Lotterieergebnisse für ein bestimmtes Datum zurück.

Parameter

Typ

Beschreibung

date

str

Datum im Format YYYY-MM-DD. Leer = aktuellste

Beispielantwort:

{
  "data": [
    { "lottery": "Lotería Nacional", "result": "1234", "date": "2026-04-24" }
  ]
}

🧪 Ausführen im Entwicklungsmodus

Um den Server direkt über das Terminal zu testen:

uv run mcp dev loteria.py

Dies öffnet den MCP Inspector im Browser, wo Sie die Tools interaktiv aufrufen können.


📦 Abhängigkeiten

Paket

Beschreibung

httpx

Asynchroner HTTP-Client für API-Aufrufe

mcp[cli]

Model Context Protocol Framework


📁 Projektstruktur

loteria/
├── loteria.py        # Servidor MCP con las herramientas expuestas
├── main.py           # Punto de entrada alternativo
├── pyproject.toml    # Configuración del proyecto y dependencias
├── uv.lock           # Lock file de dependencias (uv)
├── .gitignore
└── README.md

📄 Lizenz

MIT

Available Tools

2 tools
get_lotteriesA

Obtiene el listado de todas las loterías disponibles.

Consulta el endpoint `/lotteries` de la API de resultados de loterías
y retorna la información de cada lotería registrada (nombre, país, etc.).

Returns:
    dict[str, Any] | None: Diccionario con la lista de loterías disponibles,
    o None si ocurre un error de red o la API no responde.

Example:
    >>> await get_lotteries()
    {"data": [{"id": 1, "name": "Lotería Nacional", ...}, ...]}

Inputs: no named parameters. Returns: result

get_resultadosA

Obtiene los resultados de loterías para una fecha específica.

Consulta el endpoint `/results/{date}` de la API cuando se proporciona
una fecha, o `/results` para obtener los resultados más recientes.

Args:
    date (str): Fecha en formato `YYYY-MM-DD` para filtrar los resultados.
        Si se pasa una cadena vacía, retorna los resultados más recientes.

Returns:
    dict[str, Any] | None: Diccionario con los resultados de loterías
    para la fecha indicada, o None si ocurre un error de red o la API
    no responde.

Example:
    >>> await get_resultados("2026-04-24")
    {"data": [{"lottery": "Lotería Nacional", "result": "1234", ...}]}

Inputs: date (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one lists all available lotteries, the other retrieves results for a specific date. There is no risk of confusion.

    Naming Consistency5/5

    Both tools follow a consistent 'get_<resource>' pattern in snake_case, using the same language (Spanish) throughout.

    Tool Count3/5

    Two tools is minimal but reasonable for a simple read-only lottery information server. It borders on feeling thin but does not warrant a lower score.

    Completeness3/5

    The server covers listing lotteries and fetching results by date, but lacks features like filtering by lottery or retrieving historical results beyond a single date.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers