Sports MCP Server

<strong>基于 Model Context Protocol Python SDK 构建</strong>

概述

使用 Model Context Protocol (MCP) 实现的 Python 服务器，用于通过 SportRadar 获取实时体育统计数据。

支持的体育项目

• 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 配置设置
  • 参数
    • language (str)
    • access_level (str) -> 试用或生产 API 密钥
    • format (str) -> 数据返回格式（JSON 或 XML）
• get_schedule
  • 获取特定周的体育赛事赛程
  • 参数
    • sport (str)
    • week (int)
    • type (str) -> 季节类型（PRE, REG, PST）
    • year (int)
• get_daily_transactions
  • 获取全年体育团队的交易信息
  • 参数
    • year (int)
    • month (int)
    • day (int)
    • sport (str)
• get_game_stats
  • 使用比赛ID获取特定体育比赛的统计信息
  • 参数
    • game_id (str)
    • sport (str)
• get_league_info
  • 获取所提供体育项目中每个球队的顶级信息
  • 参数
    • sport (str)
• get_team_roster
  • 获取所提供体育项目中的特许经营球队信息及完整的球员名单
  • 参数
    • team_id (str)
    • sport (str)
• get_tournament_list
  • 获取该年度内进行的体育项目锦标赛列表
  • 参数
    • sport (str)
    • year (int)
• get_tournament_info
  • 获取正在进行的体育项目锦标赛的信息
  • 参数
    • tournament_id (str)
    • sport (str)
• get_player_stats
  • 获取所提供体育项目中每个球员的顶级信息
  • 参数
    • sport (str)
    • player_id (str)
• get_address
  • 根据给定的坐标（纬度和经度）找到地址
  • 参数
    • lat (float)
    • lon (float)

在 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。如果有足够的兴趣，将会添加更多的体育项目。

如果您想创建自己的体育项目支持，可以 fork 这个仓库，并且可以自己创建一个 MCP 服务器，或者向当前服务器推送更改。

大多数代码内部都有 DOCTYPE 注释，说明如何添加新的体育项目，具体来说，要添加一个新的体育项目：

1. 在 sportsclasses.py 内创建一个新的体育项目
2. 更新 MCP 资源（更具体地说是更新 parser_map，以包含您的体育项目解析函数）
3. 根据需要更新 MCP 工具（您需要更新工具中的注解参数）

许可证

本项目采用 MIT 许可证 - 详情见 LICENSE 文件。