The Blue Alliance

The Blue Alliance MCP 服务

一个模型上下文协议（MCP）服务，可访问 The Blue Alliance API，获取 FIRST Robotics Competition 数据。让 AI 助手和其他 MCP 客户端能够检索全面的 FRC 队伍、赛事和比赛信息。

功能

• 队伍信息：获取详细的队伍简介、参赛历史、奖项和媒体
• 赛事数据：访问赛事详情、排名、比赛和淘汰赛联盟
• 比赛结果：检索包含得分、联盟和详细数据的比赛信息
• 历史数据：查询 1992 年至当前年份的数据
• 类型安全：使用 Zod 架构验证所有响应
• 全面覆盖：35+ 个工具，涵盖所有主要 TBA API 端点

安装

npm（推荐）

npm install -g @withinfocus/tba-mcp-server

Docker

从 GitHub Container Registry 拉取镜像：

docker pull ghcr.io/withinfocus/tba-mcp-server:latest

或在本地构建：

git clone https://github.com/withinfocus/tba-mcp-server.git
cd tba-mcp-server
docker build -t tba-mcp-server .

配置

1. 从 The Blue Alliance 获取 API 密钥

2. 将 API 密钥设置为环境变量：

export TBA_API_KEY=your_api_key_here

或创建一个 .env 文件：

TBA_API_KEY=your_api_key_here

使用方法

使用 npm

将其添加到 MCP 客户端配置中（例如 Claude Desktop）：

{
  "mcpServers": {
    "tba": {
      "command": "npx",
      "args": ["-y", "@withinfocus/tba-mcp-server"],
      "env": {
        "TBA_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用 Docker

将其添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "tba": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--init",
        "-e",
        "TBA_API_KEY=your_api_key_here",
        "ghcr.io/withinfocus/tba-mcp-server:latest"
      ]
    }
  }
}

或直接运行：

docker run --rm -i --init \
  -e TBA_API_KEY=your_api_key_here \
  ghcr.io/withinfocus/tba-mcp-server:latest

可用工具

队伍信息（24 个工具）

访问全面的队伍数据，包括简介、参赛历史、赛事、比赛、奖项和媒体。

主要工具：get_team、get_team_events、get_team_matches、get_team_awards、get_team_media

赛事信息（19 个工具）

查询赛事详情、参赛者、排名、比赛和分析数据。

主要工具：get_event、get_events、get_event_teams、get_event_rankings、get_event_matches、get_event_oprs

比赛信息（3 个工具）

检索详细的比赛数据，包括得分、联盟和机器人跟踪信息。

主要工具：get_match、get_match_simple、get_match_zebra

分区工具（8 个工具）

访问分区排名、赛事和队伍信息。

主要工具：get_districts、get_district_rankings、get_district_events、get_district_teams

通用／实用工具（6 个工具）

分页列出队伍并获取 API 状态信息。

主要工具：get_teams、get_teams_by_year、get_status

完整文档

• 所有工具 - 35+ 个工具的完整参考，包含参数和示例
• 数据架构 - 所有响应类型的详细架构文档

快速示例

获取队伍信息

// Get detailed team profile
get_team(team_key: "frc86")

// Get team's events in a year
get_team_events(team_key: "frc86", year: 2024)

// Get team's awards
get_team_awards(team_key: "frc86", year: 2024)

分析赛事

// Get event details
get_event(event_key: "2024casj")

// Get participating teams
get_event_teams(event_key: "2024casj")

// Get rankings
get_event_rankings(event_key: "2024casj")

// Get elimination alliances
get_event_alliances(event_key: "2024casj")

获取比赛数据

// Get detailed match information
get_match(match_key: "2024casj_qm1")

// Get robot tracking data (if available)
get_match_zebra(match_key: "2024casj_qm1")

参与贡献

欢迎贡献！有关开发环境设置、测试指南以及如何添加新工具，请参阅 CONTRIBUTING.md。

相关链接

• The Blue Alliance - 官方 FRC 数据源
• TBA API 文档 - 官方 API 文档
• 模型上下文协议 - MCP 规范
• FIRST Robotics Competition - 官方 FRC 网站