项目简介

Sleeper 梦幻橄榄球 MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端应用，旨在为大型语言模型 (LLM) 客户端（如 Claude Desktop、Cursor、ChatGPT Custom GPT）提供标准化的接口，以访问和管理 Sleeper 梦幻橄榄球平台的数据和功能。它将复杂的橄榄球数据和分析能力封装成 LLM 易于理解和调用的工具，包括统一数据访问、梦幻足球推荐、阵容管理和实用工具。

主要功能点

用户与联赛管理： 查询 Sleeper 用户信息、列出用户在指定赛季的梦幻橄榄球联赛。
统一数据访问： 提供对联赛、阵容、选秀、球员和交易数据的整合访问。
球员与市场分析： 查询球员预期得分、ADP（平均选秀位置）和热门增减数据。
梦幻足球推荐： 提供选秀策略、弃将拾取、交易分析和季后赛规划的智能建议。
阵容管理： 优化阵容、验证球员资格、进行球员对比分析。
战术工具： 配置选秀和赛季的整体策略。
实用工具： 解析当前 NFL 赛程周、健康检查、缓存管理和工具发现。

安装步骤

该仓库是一个 Laravel 项目，需要标准的 PHP 环境、Composer 和 Node.js/npm (用于前端资产)。

克隆仓库： 'git clone https://github.com/MichaelCrowcroft/sleeper-draft.git'
进入项目目录： 'cd sleeper-draft'
安装 PHP 依赖： 'composer install'
复制环境变量文件： 'cp .env.example .env'
生成应用密钥： 'php artisan key:generate'
配置数据库： 在 '.env' 文件中配置数据库连接信息（例如 SQLite, MySQL）。
运行数据库迁移： 'php artisan migrate'
安装前端依赖： 'npm install'
编译前端资产： 'npm run dev' 或 'npm run build'
启动 Laravel 开发服务器： 'php artisan serve' （如果使用本地服务器，如 Laravel Herd，则配置域名）
配置 MCP 服务器： 确保 'config/mcp-server.php' 中的 'enabled' 设为 'true'。

MCP 客户端配置示例

这是一个 MCP 服务器，用于与支持 MCP 协议的 LLM 客户端进行通信。客户端需要配置服务器的访问信息。以下是针对 Claude Desktop 和 Cursor 客户端的配置示例：

1. Claude Desktop 配置 创建或编辑文件：'~/Library/Application Support/Claude/claude_desktop_config.json' 将以下 JSON 配置添加到 'mcpServers' 对象中：

{
  "fantasy-football-mcp": {
    "command": "npx",
    "args": [
      "-y",
      "supergateway",
      "--streamableHttp",
      "https://www.sleeperdraft.com/mcp"
    ],
    "name": "Sleeper Fantasy Football MCP Server",
    "description": "提供 Sleeper 梦幻橄榄球数据访问、战术建议和阵容管理工具。",
    "tools": [
      "fetch-trending-players",
      "fetch-adp-players",
      "fetch-user-leagues",
      "draft-picks",
      "get-league",
      "fetch-roster",
      "fetch-transactions",
      "fetch-matchups",
      "fetch-players-season-data",
      "fetch-player-season-data"
    ]
  }
}

'"fantasy-football-mcp"': 这是您为该 MCP 服务器指定的唯一标识符。
'"command"': 启动 MCP 服务器的命令。这里使用了 'npx supergateway' 作为代理工具。
'"args"': 传递给 'command' 的参数列表。'"--streamableHttp"' 指示通过 HTTP 流协议连接到服务器的端点 'https://www.sleeperdraft.com/mcp'。
'"name"': 服务器的友好显示名称。
'"description"': 服务器功能的简要描述。
'"tools"': 该服务器暴露给 LLM 客户端的工具列表。

2. Cursor 配置 创建或编辑文件：'~/.cursor/mcp.json' 将以下 JSON 配置添加到 'mcpServers' 对象中：

{
  "fantasy-football-mcp": {
    "transport": {
      "type": "http",
      "url": "https://www.sleeperdraft.com/mcp"
    },
    "name": "Sleeper Fantasy Football MCP Server",
    "description": "提供 Sleeper 梦幻橄榄球数据访问、战术建议和阵容管理工具。",
    "tools": [
      "fetch-trending-players",
      "fetch-adp-players",
      "fetch-user-leagues",
      "draft-picks",
      "get-league",
      "fetch-roster",
      "fetch-transactions",
      "fetch-matchups",
      "fetch-players-season-data",
      "fetch-player-season-data"
    ]
  }
}

'"fantasy-football-mcp"': 这是您为该 MCP 服务器指定的唯一标识符。
'"transport"': 定义客户端与服务器通信的方式。
- '"type"': 通信协议类型，这里是 '"http"'。
- '"url"': MCP 服务器的 HTTP 端点地址，例如 'https://www.sleeperdraft.com/mcp'。
'"name"': 服务器的友好显示名称。
'"description"': 服务器功能的简要描述。
'"tools"': 该服务器暴露给 LLM 客户端的工具列表。

请注意，'https://www.sleeperdraft.com/mcp' 是项目的线上公共端点。如果您在本地运行服务器，请将 URL 替换为 'http://sleeperdraft.test/mcp' （如果您使用 Laravel Herd 等工具）或您本地 Laravel 开发服务器的实际 URL（例如 'http://127.0.0.1:8000/mcp'）。

基本使用方法

配置完成后，重启您的 LLM 客户端。在客户端的 MCP 服务器设置中，您将看到名为 "Sleeper Fantasy Football MCP Server" 的新服务器。现在，您可以直接向您的 LLM 提问，它将能够利用此 MCP 服务器提供的工具来获取 Sleeper 梦幻橄榄球数据并提供智能分析。例如：

"查询用户 'MichaelCrowcroft' 的所有梦幻橄榄球联赛。" (使用 'fetch-user-leagues' 工具)
"Christian McCaffrey 的当前 ADP 是多少？" (使用 'fetch-adp-players' 工具)
"给我一些关于下一周阵容优化的建议。" (这将需要 LLM 结合多个工具进行复杂推理)
"本周热门的球员增减有哪些？" (使用 'fetch-trending-players' 工具)
"分析这笔交易：我用 CMC 换取 Bijan Robinson。" (这将需要 LLM 结合多个工具进行复杂推理)

关键词

项目简介

主要功能点

安装步骤

MCP 客户端配置示例

基本使用方法

信息