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.
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.-