Skip to main content
Glama
Lotería MCP

Lotería MCP

by parrotsoft

🎟️ Lotería MCP

Lottery Results API を使用して宝くじや結果を照会するための MCP サーバーです。

互換性のある MCP クライアント(Claude Desktop、Cursor など)がチャットから直接呼び出せる 2 つのツールを提供します。


📋 要件

ツール

最小バージョン

Python

3.10+

uv

latest


Related MCP server: Marvel MCP

⚙️ インストール

1. リポジトリのクローン

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

2. 仮想環境の作成と 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

特定の日の宝くじ結果を返します。

パラメータ

型

説明

date

str

YYYY-MM-DD 形式の日付。空の場合は最新の結果

レスポンス例:

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

🧪 開発モードでの実行

ターミナルから直接サーバーをテストするには:

uv run mcp dev loteria.py

これによりブラウザで MCP Inspector が開き、対話的にツールを呼び出すことができます。


📦 依存関係

パッケージ

説明

httpx

API 呼び出し用の非同期 HTTP クライアント

mcp[cli]

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