Tba MCP Server

🚀 蓝色联盟MCP服务器

这是一个模型上下文协议（MCP）服务器，它提供对蓝色联盟（The Blue Alliance）API的访问，用于获取FIRST机器人竞赛数据。该服务器使AI助手和其他MCP客户端能够检索全面的FRC团队、赛事和比赛信息。

✨ 主要特性

• 团队信息：获取详细的团队资料、参赛历史、获奖情况和媒体信息。
• 赛事数据：访问赛事详情、排名、比赛和淘汰赛联盟信息。
• 比赛结果：检索包含得分、联盟和比赛分析的比赛数据。
• 历史数据：查询1992年至今的数据。
• 类型安全：所有响应都通过Zod模式进行验证。
• 全面覆盖：35+种工具涵盖了蓝色联盟API的所有主要端点。

📦 安装指南

从npm安装

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

从源代码安装

git clone https://github.com/withinfocus/tba-mcp-server.git
cd tba-mcp-server
npm ci
npm run build

🔧 配置

将你的蓝色联盟API密钥设置为环境变量：

export TBA_API_KEY=your_api_key_here

或者创建一个 .env 文件：

TBA_API_KEY=your_api_key_here

💻 使用示例

基础用法

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

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

高级用法

获取团队信息

// 获取详细的团队资料
get_team(team_key: "frc86")

// 获取团队在某一年的赛事信息
get_team_events(team_key: "frc86", year: 2024)

// 获取团队的获奖情况
get_team_awards(team_key: "frc86", year: 2024)

分析赛事

// 获取赛事详情
get_event(event_key: "2024casj")

// 获取参赛团队
get_event_teams(event_key: "2024casj")

// 获取排名
get_event_rankings(event_key: "2024casj")

// 获取淘汰赛联盟
get_event_alliances(event_key: "2024casj")

获取比赛数据

// 获取详细的比赛信息
get_match(match_key: "2024casj_qm1")

// 获取机器人跟踪数据（如果可用）
get_match_zebra(match_key: "2024casj_qm1")

📚 详细文档

可用工具

团队信息（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+种工具的完整参考，包含参数和示例。
• 数据模式 - 所有响应类型的详细模式文档。
• 开发指南 - 构建、测试和贡献的相关说明。

🔨 开发

有关以下方面的详细说明，请参阅开发指南：

• 构建和测试
• 添加新工具
• 运行单元测试和集成测试
• 代码标准和贡献指南

快速开始：

npm ci                   # 安装依赖
npm run build            # 构建TypeScript
npm test                 # 运行单元测试
npm run test:integration # 运行集成测试
npm run lint             # 检查代码质量
npm run inspect          # 启动MCP检查器

🔗 相关链接

• 蓝色联盟 - 官方FRC数据源
• 蓝色联盟API文档 - 官方API文档
• 模型上下文协议 - MCP规范
• FIRST机器人竞赛 - 官方FRC网站