Lotería MCP
🎟️ MCP 복권
복권 결과 API를 통해 복권 및 결과를 조회하기 위한 MCP 서버입니다.
모든 호환 가능한 MCP 클라이언트(Claude Desktop, Cursor 등)가 채팅에서 직접 호출할 수 있는 두 가지 도구를 제공합니다.
📋 요구 사항
도구 | 최소 버전 |
Python | 3.10+ |
최신 |
Related MCP server: Marvel MCP
⚙️ 설치
1. 저장소 복제
git clone https://github.com/parrotsoft/loteria-mcp
cd loteria2. 가상 환경 생성 및 uv를 사용하여 의존성 설치
uv sync이 명령은 자동으로 .venv 환경을 생성하고 pyproject.toml에 선언된 모든 의존성을 설치합니다.
🚀 Claude Desktop에서 사용하기
Claude Desktop 설정 파일에 다음 구성을 추가하세요:
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"
]
}
}
}참고:
/ruta/absoluta/al/proyecto/loteria를 사용자의 컴퓨터에 있는 실제 프로젝트 경로로 바꾸세요.
Claude Desktop을 재시작하면 서버를 사용할 수 있습니다.
🛠️ 사용 가능한 도구
get_lotteries
API에서 제공하는 전체 복권 목록을 반환합니다.
매개변수 없음.
응답 예시:
{
"data": [
{ "id": 1, "name": "Lotería Nacional", "country": "MX" },
{ "id": 2, "name": "Melate", "country": "MX" }
]
}get_resultados
특정 날짜의 복권 결과를 반환합니다.
매개변수 | 유형 | 설명 |
|
|
|
응답 예시:
{
"data": [
{ "lottery": "Lotería Nacional", "result": "1234", "date": "2026-04-24" }
]
}🧪 개발 모드 실행
터미널에서 서버를 직접 테스트하려면 다음을 실행하세요:
uv run mcp dev loteria.py브라우저에서 MCP Inspector가 열리며, 여기서 대화형으로 도구를 호출할 수 있습니다.
📦 의존성
패키지 | 설명 |
| API 호출을 위한 비동기 HTTP 클라이언트 |
| Model Context Protocol 프레임워크 |
📁 프로젝트 구조
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📄 라이선스
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.
Maintenance
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.-