Sleeper MCP

公開の Sleeper API 向けの読み取り専用の Model Context Protocol サーバーです。users、leagues、rosters、matchups、transactions、drafts、players、trending activity、playoff brackets、traded picks、sport state を、非同期の FastMCP ツールを通じて公開します。

Sleeper は API キーを必要としません。文書化されたガイダンスに従い、1 分あたり 1,000 リクエスト未満に抑えてください。完全な players レスポンスは数メガバイトあり、通常は 1 日に 1 回を超えて取得しないでください。

インストール

Python 3.11 以降と uv が必要です。

uv sync

Related MCP server: flaim

実行

サーバーはデフォルトで MCP の stdio トランスポートを使用します:

uv run sleeper-mcp

同等のモジュールコマンドは次のとおりです:

uv run python -m sleeper_mcp.server

Docker

イメージは alpine:latest をベースとしており、stdio 経由で MCP サーバーを実行します。クライアントが stdin でプロセスと通信できるように、-i を維持してください。

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

Cursor (Docker)

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

Claude Desktop (Docker)

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

MCP クライアントを設定する

クライアント設定では、ワークスペースの絶対パスを使用してください（または上記の Docker コマンドを使用します）。

Cursor

このサーバーを Cursor の MCP 設定に追加します:

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

Claude Desktop

Claude Desktop の設定の mcpServers の下に同じエントリを追加します:

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

設定を変更した後、クライアントを再起動してください。

開発

uv run pytest

パッケージはレイヤー構造を採用しています:

• client.py は HTTP 関連の処理と Sleeper のベース URL を担当します。

• service.py はメソッドを文書化された API エンドポイントにマッピングします。

• tools.py はサービスメソッドを文書化し、MCP ツールとして公開します。

• server.py はレイヤーを結び付け、FastMCP を起動します。