Lotería MCP
🎟️ 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+ |
latest |
Related MCP server: Marvel MCP
⚙️ Installation
1. Repository klonen
git clone https://github.com/parrotsoft/loteria-mcp
cd loteria2. Virtuelle Umgebung erstellen und Abhängigkeiten mit uv installieren
uv syncDies 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/loteriadurch 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 |
|
| Datum im Format |
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.pyDies öffnet den MCP Inspector im Browser, wo Sie die Tools interaktiv aufrufen können.
📦 Abhängigkeiten
Paket | Beschreibung |
| Asynchroner HTTP-Client für API-Aufrufe |
| 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 toolsget_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
Scored across 2 tools
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.
Both tools follow a consistent 'get_<resource>' pattern in snake_case, using the same language (Spanish) throughout.
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.
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.
Related MCP Connectors
MCP server for the Seline Analytics API
MCP server for Google search results via SERP API
MCP server for the GovContractScout US government contracts API: search, NAICS, match scoring.
The official MCP Server for the Mux API
Related MCP Servers
- -licenseNot gradedqualityBmaintenanceMCP Server for the Google Maps API.11,868 npm92,139MIT
- AlicenseBqualityFmaintenanceMCP Server for the Marvel Developer API, enabling interaction with characters and comics data.762 npm14MIT
- FlicenseAqualityDmaintenanceMCP server for the Concept2 Logbook API, enabling user profile management, workout result operations, and challenge queries.14-
- FlicenseNot gradedqualityDmaintenanceA simple MCP server to call RMV APIs for nearby stations and departure boards.-