Lotería MCP
🎟️ Lotería MCP
Lottery Results API を使用して宝くじや結果を照会するための MCP サーバーです。
互換性のある MCP クライアント(Claude Desktop、Cursor など)がチャットから直接呼び出せる 2 つのツールを提供します。
📋 要件
ツール | 最小バージョン |
Python | 3.10+ |
latest |
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.-