体育数据服务

基于Model Context Protocol的Python服务器,提供实时体育统计数据交互功能,支持NFL等多种体育项目。

  • by reeeeemo
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 reeeeemo/mcp-sports

使用说明

体育MCP服务器

建在 模型上下文协议Python SDK

概述

Python服务器实现了模型上下文协议(MCP),通过以下方式与实时体育统计数据进行交互 运动雷达

支持体育

  • NFL 联赛

注: 请检查 发展 增加更多运动支持

特性

  • 获取比赛、联赛和球员统计数据
  • 获取团队名册和时间表
  • 获取锦标赛信息和玩家交易

注: 服务器将需要来自SportRadar的API密钥。 这是说明链接

资源

  • sports://seasonsched/{_cache}:赛季时间表缓存
  • sports://leaguetransactions/{_cache}:联盟事务缓存/解析器
  • sports://gamestats/{_cache}:游戏统计缓存
  • sports://leaguestats/{_cache}:联赛数据缓存
  • sports://teamstats/{_cache}:团队统计数据缓存
  • sports://playerstats/{_cache}:玩家统计数据缓存

工具

  • update_api_config
    • 更新SportRadar的API配置设置
    • 参数
      • 语言(str)
      • access_level(str)->试用或生产api密钥
      • format(str)->数据返回格式(JSON或XML)
  • get_schedule
    • 获取给定运动的特定周时间表
    • 参数
      • 体育(str)
      • 周(int)
      • 类型(str)->季节类型(PRE、REG、PST)
      • 年份(int)
  • get_daily_transactions
    • 获取运动队全年交易信息
    • 参数
      • 年份(int)
      • 月份(整数)
      • 日(int)
      • 体育(str)
  • get_game_stats
    • 使用特定体育游戏的ID获取其统计信息
    • 参数
      • game_id(str)
      • 体育(str)
  • get_league_info
    • 获取所提供运动中每个团队的顶级信息
    • 参数
      • 体育(str)
  • get_team_roster
    • 获取特许经营团队信息+所提供运动的完整球员名单
    • 参数
      • team_id(str)
      • 体育(str)
  • get_journament_list
    • 获取当年该运动正在进行的锦标赛列表
    • 参数
      • 体育(str)
      • 年份(int)
  • get_journament_info
    • 获取该运动正在进行的锦标赛的信息
    • 参数
      • 锦标赛id(str)
      • 体育(str)
  • get_player_stats
    • 获取所提供运动中每个球员的顶级信息
    • 参数
      • 体育(str)
      • player_id(str)
  • 获取地址
    • 当给定坐标(lat和lon)时,找到地址
    • 参数
      • lat(浮动)
      • lon(浮动)

使用Claude Desktop

手动安装

  1. 首先,安装软件包: pip install mcp-sports-server

  2. 将此添加到您的 claude_desktop_config.json

{
  "mcpServers": {
     "sports": {
       "command": "mcp-sports-server",
       "args": ["--api-key", "your_api_key"]
     }
  }
}

发展

目前只有NFL支持。如果有足够的兴趣,将增加更多的体育项目。

如果你想创建自己的运动支持,你可以分叉这个仓库,制作自己的MCP服务器,或者将更改推送到当前的服务器。

里面的大部分代码都有关于如何添加新运动的DOCTYPE注释,本质上是添加新运动:

  1. 在内部创建一项新的运动 sportsclasses.py
  2. 更新MCP资源 (更具体地说 parser_map 包括你的运动解析功能)
  3. 根据需要更新MCP工具 (您需要更新工具中的注释参数)

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。