Sleeper MCP

Un servidor Model Context Protocol de solo lectura para la API pública de Sleeper. Expone usuarios, ligas, alineaciones, partidos, transacciones, drafts, jugadores, actividad de tendencias, cuadros de playoffs, selecciones intercambiadas y estado deportivo a través de herramientas FastMCP asíncronas.

Sleeper no requiere clave de API. Respeta sus pautas documentadas para mantenerte por debajo de 1000 solicitudes por minuto. La respuesta completa de jugadores ocupa varios megabytes y, por lo general, no debería obtenerse más de una vez al día.

Instalación

Requiere Python 3.11 o superior y uv.

uv sync

Related MCP server: flaim

Ejecución

El servidor usa el transporte stdio de MCP por defecto:

uv run sleeper-mcp

El comando de módulo equivalente es:

uv run python -m sleeper_mcp.server

Docker

La imagen se basa en alpine:latest y ejecuta el servidor MCP sobre stdio. Mantén -i para que el cliente pueda hablar con el proceso en stdin.

docker build -t sleeper-mcp .
docker run --rm -i sleeper-mcp

Cursor (Docker)

{
  "mcpServers": {
    "sleeper": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "sleeper-mcp"
      ]
    }
  }
}

Claude (Docker)

{
  "mcpServers": {
    "sleeper": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "sleeper-mcp"
      ]
    }
  }
}

Configurar un cliente MCP

Usa la ruta absoluta de tu espacio de trabajo en la configuración de tu cliente (o los comandos de Docker anteriores).

Cursor

Añade el servidor a tu configuración MCP de Cursor:

{
  "mcpServers": {
    "sleeper": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/talweiss/Desktop/codeProjects/sleeper-mcp",
        "run",
        "sleeper-mcp"
      ]
    }
  }
}

Claude Desktop

Añade la misma entrada bajo mcpServers en la configuración de Claude Desktop:

{
  "mcpServers": {
    "sleeper": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/talweiss/Desktop/codeProjects/sleeper-mcp",
        "run",
        "sleeper-mcp"
      ]
    }
  }
}

Reinicia el cliente después de cambiar su configuración.

Desarrollo

uv run pytest

El paquete sigue un diseño en capas:

• client.py gestiona las solicitudes HTTP y la URL base de Sleeper.

• service.py documenta los endpoints de la API.

• tools.py documenta y expone los métodos del servicio como herramientas MCP.

• server.py conecta las capas e inicia FastMCP.