项目简介

Token Bowl 梦幻足球MCP服务是一个基于Model Context Protocol (MCP) 构建的后端应用。它专门为Token Bowl梦幻橄榄球联赛设计，集成了Sleeper Fantasy Sports API，并利用Redis进行高性能数据缓存。该服务旨在以标准化的MCP接口向大型语言模型（LLM）客户端提供丰富的梦幻橄榄球数据和分析能力。

主要功能点

全面联赛管理: 获取联赛信息、团队阵容、比赛对阵、交易记录和季后赛赛程等详细数据。
用户与球员数据: 追踪用户档案、球员统计数据，支持实时NFL球员数据查询，并提供Redis缓存以加速检索。
趋势分析: 监控哪些球员最近被大量添加或放弃，帮助用户了解市场动态。
选秀工具: 查询历史选秀记录和交易的选秀权。
高性能: 利用Redis缓存关键球员数据（例如，所有NFL球员数据），缓存数据TTL（生存时间）为24小时并支持自动刷新。
双重传输支持: 支持STDIO模式（适用于Claude Desktop等本地客户端）和HTTP/SSE模式（适用于Web部署），提供灵活的连接选项。

安装步骤

克隆仓库: 打开终端，运行以下命令将项目克隆到本地计算机。

git clone https://github.com/GregBaugues/tokenbowl-mcp.git
cd tokenbowl-mcp

安装依赖: 使用'uv'包管理器安装Python依赖项。
```
uv sync
```
配置环境变量:
- 复制示例配置文件，创建'.env'文件。
```
cp .env.example .env
```
- 编辑新创建的'.env'文件，根据需要配置以下环境变量：
  - 'FFNERD_API_KEY': Fantasy Nerds API Key (可选，用于扩展分析功能，如更详细的伤病和新闻)。
  - 'SLEEPER_LEAGUE_ID': 你的Sleeper联赛ID (可选，默认为Token Bowl联赛的ID)。
  - 'REDIS_URL': Redis连接URL (可选，用于缓存数据，生产环境推荐配置)。

服务器配置 (供MCP客户端使用)

该MCP服务器可以通过两种模式运行，并提供相应的客户端配置信息。MCP客户端（如Claude Desktop）需要这些信息来连接服务器。

作为本地应用（STDIO模式，推荐用于Claude Desktop）: MCP客户端需要配置服务器的启动命令。以下是一个示例JSON配置，请根据你的实际情况进行调整。

{
  "mcpServers": {
    "tokenbowl-local": {
      "command": "sh",
      "args": [
        "-c",
        "cd /path/to/tokenbowl-mcp && uv run python sleeper_mcp.py"
      ],
      "description": "本地运行的Token Bowl梦幻橄榄球MCP服务器"
    }
  }
}

'tokenbowl-local': MCP客户端中为此服务器设置的唯一标识名称。
'command': 用于启动服务器的shell命令。
'args': 传递给shell命令的参数列表。
重要提示: 请务必将 '/path/to/tokenbowl-mcp' 替换为你实际克隆 'tokenbowl-mcp' 仓库的绝对路径。

作为托管服务（HTTP/SSE模式，推荐用于Web客户端）: 如果MCP服务器已部署在云端（例如Render平台），MCP客户端可以直接通过HTTP/SSE URL连接。

{
  "mcpServers": {
    "tokenbowl-hosted": {
      "url": "https://tokenbowl-mcp.haihai.ai/sse",
      "description": "已托管的Token Bowl梦幻橄榄球MCP服务器"
    }
  }
}

'tokenbowl-hosted': MCP客户端中为此服务器设置的唯一标识名称。
'url': 已部署MCP服务器的HTTP/SSE接口地址。

基本使用方法

一旦MCP客户端连接成功，你就可以通过大型语言模型（LLM）向MCP服务器发起请求，利用其提供的工具获取梦幻橄榄球数据和洞察：

查询联赛信息: 例如，询问“获取Token Bowl联赛的当前设置。”
查看球队阵容: 例如，询问“显示Roster ID为2的球队阵容。”（Roster ID可在'get_league_rosters'工具中获取）。
搜索球员: 例如，询问“搜索名叫Patrick Mahomes的球员。”
分析球员趋势: 例如，询问“哪些球员最近被大量添加？”
获取球员完整统计数据: 例如，询问“给我Patrick Mahomes在2024赛季的所有周统计数据。”
分析自由球员市场: 例如，询问“显示可用的跑卫自由球员。”或“分析一下最近被放弃的球员。”

关键词

项目简介

主要功能点

安装步骤

服务器配置 (供MCP客户端使用)

基本使用方法

信息